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1 INTRODUCTION 


This edition of the OneOS Voice Manual corresponds to the OneOS V4.2 software release. 


The OneOS V4.2 software developed for use with the ONE product range offers an extensive range of 
features designed to provide a complete & highly powerful range of multi-service access routers: 


e = Full IP router with NAPT, Security, and Quality of Service management 

e Support of voice for analog and ISDN SO/TO terminals using Voice over IP and Voice over ATM 
e — Interworking of data protocols (FR, X.25, PAD, XOT, X.31) 

e Advanced management tools based on CLI (Command Line Interface), SNMP, FTP/TFTP 


This document is the OneOS user guide for voice-related functions of the OneOS-based range products 
that have a model name with a three-digit number ending in zero (ONEXX0O — Example: ONE100). 
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FEATURE MATRIX 


The following table is a resource providing edition by edition the released features. The table was done as 
of the release V3.5R2E3. For simplification, the indicated software release shows the presence of a 
feature in a given software release. It should be noted that most features were available in earlier versions. 























































































































Main Function | Feature Present at least in: 
Circuit Emulation} CES over E1 (ONE200): structured/ unstructured mode V3.5R2E3 
Service (AAL-1) | | oops on the serial/E1 and ATM sides V3.5R2E3 
CES over serial (V.11/X.21, V.35) (ONE200) V3.5R2E3 
Voice over AAL-2| BLES (AF-VMOA-00145): voice over AAL-2 V3.5R2E3 
VTOA-113 (trunking over AAL-2) V3.5R2E3 
Debug V5 signaling V3.5R2E3 
G.711 and G.726 voice coding V3.5R2E3 
AAL-2 cell multiplexing (bandwidth optimization) V3.5R2E3 
Echo cancellation disabling when detecting fax/modem V3.5R2E3 
Configurable ringing tones for various countries V3.5R2E3 
Clock synchronization: AAL-2, DSL, free-run, slave V3.5R2E3 
configurable jitter V3.5R2E3 
Silence detection / comfort noise V3.5R2E3 
VoIP H.323 Fast connect V3.5R2E3 
H.323 V4 V3.5R2E3 
RAI support V3.5R2E3 
Intrusive mode (connection enabled when local voice ports V3.5R2E3 
are up) 
Support of en-bloc and overlap dialing V3.5R2E3 
Direct call (automatic call after off-hook) V3.5R2E3 
Fully configurable ringing tones V3.5R2E3 
FSK/DTMF caller-id presentation on POTS terminal V3.5R2E3 
interface 
Voice call routing V3.5R2E3 
- between local ports V3.5R2E3 
- backup routing V3.5R2E3 
- pre- and pos-routing calling/called number translation V3.5R2E3 
(translation based on wildcards) 
- call routing to a group of interfaces (call distribution based V3.5R2E3 
on priority and round robin) 
- call routing to a group of interfaces (call distribution based V4.2R5E15 
on priority and least load port) 
Call hunting V3.5R2E3 
CLIP / CLIR / COLP / COLR support for ISDN V3.5R2E3 
AOC (CS2K specific feature) V3.5R2E3 
Codec: G.711, G729A, clear channel mode (unrestricted V3.5R2E3 
data) 
ISDN terminal synchronization from received SNTP clock V3.5R2E3 
RTP bandwidth limitation V3.5R2E3 
G3 and super G3 fax support: fax pass-through and fax V3.5R2E3 
relay (T.38) 
DTMF in H.245 and DTMF in-band (RFC 2833) V3.5R2E3 
TCS null support (reset of H.323 media channel) V3.5R2E3 
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| Echo cancellation disabling when detecting fax/modem V3.5R2E3 
Configurable ringing tones for various countries V3.5R2E3 
Clock synchronization: RTP, DSL, free-run, slave V3.5R2E3 
Configurable jitter V3.5R2E3 
Silence detection / comfort noise V3.5R2E3 
RTP extended statistics (loss, jitter, voice quality V3.5R2E3 
diagnostics) 
Force ISDN layer-2 activity V3.5R2E3 
Permanent layer-2 improvement; permanent layer-1 V4.2R5E2 
ISDN channel specialization V3.5R2E3 
Gatekeeper discovery, alternate gatekeeper support V3.5R2E3 
T.38 ECM V3.7R3E1 
MGCP MGCP for FXS interfaces V3.6R4 
Fax detection, pass-through (G.711 codec without echo V3.6R4 
cancellation switching) or relay (T.38) 
Modem detection and pass-through V3.6R4 
DTMF in-band (RFC 2833) and out-of-band (MGCP DTMF V3.6R4 
package) 

SIP SIP for BRI interface (CLIP, CLIR, en-bloc dialing) V3.6R5 
Registration V3.6R5 
WWW authentication V3.6R5 
OPTIONS V3.6R5 
Voice routing and call backup routing V3.6R5 
DTMF in-band (RFC 2833 method) V3.6R5 
Separate configuration of SIP user/password, SIP ID V3.6R5 
Authentication in INVITE V3.6R5 
Ability to change URI format in Contact and From fields V3.6R5 
T.38 ECM V3.7R3E1 
SIP Proxy with NAT ALG V3.7R3E1 
SIP request timeout configurable V3.7R10 
Internally managed FXS services (hold, retrieve, brokering, V3.7R10 
call transfer, 3-way conference) 

SIP call routing based on To field only V3.7R10 
International numbering plan management V4.2R5E2 
External conference bridge support V3.7R10 
External voicemail V3.7R10 
Configuration of request method timeout V3.7R10 
Allow discard of 3XX message V3.7R10 
SuperG3 to G3 FAX fallback V3.7R11 
Call Admission and Control V3.7R11 
Services on FXS port (intelligent mode) V3.7R11 
Services on ISDN ports V3.7R11 
HLC & LLC insertion V3.7R11 
RTP adaptive clock synchronization V3.7R11 
MWI service V3.7R11 
Compatibility with external hosted NAT traversal V3.7R11 
FXS Line Voltage Drop V3.7R11 
Emergency calls V3.7R11 
Dynamic payload type V3.7R11 
MOS Scoring | MOS-LQ/MOS-CQ calculation V4.2R5E2 
R factor display V4.2R5E2 
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3 VOICE OVER ATM & CIRCUIT EMULATION 





3.1 INTRODUCTION 


The OneOS-based voice-capable router enables the connection of conventional telephone terminals 
(ISDN or analog), or PBX (ISDN BRI/PRI or analog), to the PSTN through an ATM/DSL network in 
compliance with the Broadband Loop Emulation Service (BLES), with standard for Voice Trunking over 
ATM specified by the ATM Forum (AF-VMOA-145, AF-LES-02.03, AF-VTOA-113), or with the Circuit 
Emulation Service (CES) specified by the ATM Forum (AF-VTOA-78). The Circuit Emulation Service can 
also be offered on a serial V.11/X.24/V.28/V.36 interface for a full-transparent data connection. 


LE CO-IWF 
Class 5 Switch) (Voice Gateway) 










CP-IWF 
(ONE 400) 


















Access 





DSLAM LAN 


Architecture for access to the PSTN using BLES (Broadband Loop Emulation Service) 


3.1.1 BLES/VTOA Protocol Overview 
3.1.1.1. Signaling Processing 


The BLES protocol enables connection of conventional telephone subscribers to the switched telephone 
network by delivering an equivalent level of service: the access device (e.g. the OneOS-based voice- 
capable router) transparently transmits call signaling to the voice gateway in the Central Office (CO) 
without performing any analysis. The access device is referred to in the BLES standard as the Customer 
Premises Inter-Working Function (CP-IWF), whereas the voice gateway is referred to as the Central Office 
Inter-Working Function (CO-IWF). Additional telephone services (e.g. forwarding, transfers, double call) 
are managed directly by the Class 5 switch (LE) connected to the voice gateway. 


For SO and S2 interfaces, ISDN signaling (messages on channel D) is transparently relayed to the V5.2 
interface of the voice gateway. 


For POTS (analog) interface, only CAS mode is supported. The on-hook/off-hook states and ringing are 
transmitted in-band (in the CID allocated for the voice port). 


The VTOA protocol enables connection of an E1 PBX to a voice gateway supporting this mode. It also 
enables connection between two E1 PBX through an ATM network. As with BLES, signaling messages 
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(D channel) are transported transparently end-to-end. The ONE400 supports CCS mode (transport of 
signaling messages over a D channel); CAS (Channel Associated Signaling) mode is not supported. 


The Circuit Emulation Service (CES) enables connection of an E1 PBX to a voice gateway or ATM switch 
supporting the CES interworking function. As VTOA, it enables also connection between two E1 devices 
through the ATM network. The signaling time slots (CCS or CAS) are transported transparently end-to- 
end. 


3.1.1.2. Voice Processing (BLES / VTOA-113) 


With telephone subscribers using ISDN, the voice signal coded in PCM 64Kbps (G.711 A-law or p-law) 
from the subscriber side is either transmitted transparently or coded with a lower bit rate (e.g. in ADPCM - 
G.726- 32Kbps) by the access device. The transit delay from the subscriber to the Class 5 switch can be 
higher than a few tens of milliseconds; consequently, the access device must cancel the electric echo 
generated by the 2 wire/4 wire device inside the connected analog telephone terminals (the voice gateway 
also cancels the echo at the switched network side). In order to reduce the bandwidth requirement for 
voice communication, silence can be suppressed. During silence, the device (voice gateway or access 
device) periodically sends Silence |IDentification patterns (SID) until voice frames are received again. The 
device receiving a SID generates comfort noise in accordance to the noise level provided by the SID. 


The BLES and VTOA standards specify possible options for voice coding called profiles. A profile specifies 
the type of coders (G.711 or ADPCM G.726), the silence detection, and the frequency of voice frame 
transmission. The same profile used by a voice interface must be selected in the access equipment and 
the voice gateway. A profile specifies several coders with or without silence detection. The coder selection 
in a profile is carried out either in (configurable in the OneOS-based voice-capable router): 


e Independent Mode: A configuration parameter determines the single coder to use in the profile, or: 


e In slave mode. The coder to use is determined according to the one used by the voice gateway 
(default mode). Thus, if modem detection is implemented in the voice gateway, the modem can select 
the G.711 coder that will be used by the voice gateway with the access device (in slave mode) 
detecting the coder change. 


Thus, several telephone applications are supported: 
e Voice: A low bit rate coder can be used. 


e FAX: Preferably the G.711 coder will be used. However, a FAX communication with a bit rate lower 
than 9600 bps will be achieved with an ADPCM coder (32Kbps G.726). 


e Modem: The G.711 coder must be used. 


e Data (e.g. H.320 videoconferencing): The voice gateway can notify the access device, the call type, 
(voice, modem, and data) during the allocation of the CID. If the call type cannot be identified, a 
specific profile (transparent CES) can be configured for the voice port but will be applied to all the 
communications on this port. 


3.1.1.3. Transport over ATM 


Signaling and voice flows are multiplexed in one ATM VC by the ATM Adaptation Layer 2 (AAL2). Each 
channel is identified by a CID (Channel Identifier). A SO interface requires 3 CID (1 for the D channel and 1 
for each B channel). An analog interface requires 1 CID. The ELCP protocol (CID allocation or port control 
for BRI and PRI) requires a specific CID. For BRI and PRI, the CID assignment to the voice interfaces can 
be either static or dynamic. In the latter case, the ELCP protocol, specified in the BLES standard, is used 
(in the specific CID number 8). The voice ports are identified by a single number (1 to N) in order to enable 
the voice gateway to identify each subscriber (for incoming and outgoing calls). In case of static allocation, 
the following standardized values are used: 


1. ELCP and PSTN signaling (CCS) is not supported for analog ports. The Gateway must be 
configured in CAS mode without ELCP. 


2. ELCP is not supported in VTOA mode. All the CIDs (for each time slot) are defined in the 
configuration. ELCP is mandatory in BLES mode for PRI and recommended for BRI. 
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CID V5 and ELCP 
16..127 | Analog interface FXS 
128..159} ISDN D Channels 
160..223} ISDN B Channels 























Example: The SO port n°1 has the CID 128,160,161 for the channels D, B1, and B2. The SO port n°2 has 
the CID 129,162,163. 


The adaptation layer AAL2 optionally enables multiplexing of several voice payloads in one ATM cell 
coming from one or more channels. This operating mode enables the reduction of bandwidth by optimizing 
the filling of ATM cells (fixed length of 53 bytes) when using a low bit rate coder such as G.729 or G.723.1. 
A timer is defined for the cell emission. If the timer elapses, and no additional voice payload is to be sent to 
fully fill the ATM cell, then the cell is emitted, even if it is only partially filled. The voice payload length 
recommended by the BLES/VTOA standard is defined to minimize the ATM cell padding which results in 
greater efficiency with G.711 and G.726/G.732 coders without requiring cell multiplexing. 


The ATM bandwidth required by voice thus depends on many parameters: 
e Type of coder for each port 


e Filling rate of ATM cells (determined by the length of the voice payloads and AAL2 mode multiplexed 
or not) 


e ~—- Signaling traffic (ELCP, V5, ISDN/Canal D) 


The ATM Class of Service required by the AAL2 PVC is at least VBR-RT (or CBR). The voice frames must 
be transmitted with higher priority than cells dedicated to data transfers in order to reduce network jitter 
and transit delay for voice. The PCR (Peak Cell Rate) must be assigned in consideration of the worst case 
in order to minimize cell loss. Signaling flows however will be considered as limited. 


The PVC PCR will be calculated according to the following data: 





























Channel eae /second)| ATM bit rate (bit/second) 
Voice G.711 /5ms 200 84800 

Voice G.711 /5.5ms 182 77168 

Voice G.726-32 /10ms| 100 42400 

Voice G.726-32 /11ms] 91 38584 

D channel SO 5 2120 

D channel S2 50 21200 

ELCP signaling (SO) 5 2120 

ELCP signaling (S2) 50 21200 

















Example: Handling 4 SO ports with G.711/5.5ms requires a PCR of 1481 cells per second (cps), which is a 
rate of 627944 bps). With G.726 coding mode, the PCR would be 753 cps (ATM rate of 319272 bps). 


Most of the time average voice traffic is lower than the PCR. The telephone calls are not all permanently 
established. Silence detection enables reduction in bandwidth requirement by 50% during 
communications. 


Note: There is no consistency check between the configured PCR and the ATM bandwidth required for all 
the communications. If the PCR is too low, cells will be lost on the uplink. 


3.1.2 Circuit Emulation Service 


The Circuit Emulation Service uses AAL1 for the E1 transport through the ATM network. The ONE400/200 
is fully transparent. Consequently, neither voice encoding nor echo cancellation is performed. The optional 
DSP board is not required. 


Two modes are supported: 


e Structured: this mode enables the transport of N time slots (Nx64Kbps, N=1 to 31). The time-slot 0 
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must not be transported. 


e Unstructured: this mode allows the transport of a full E1 (2048Kbps) without G.704 processing. The 
time-slot 0 is transported transparently. 


In structured mode, in case of a low bit rate value (for example 2x64Kbps), the transit delay may be 
important (due to the time required for full ATM cell filling). For voice application, a high round-trip delay 
may require an echo-canceller. The ONE400/200 supports the "partial fill mode" that enables to send an 
ATM cell without waiting it is filled of data coming from the user. This method reduces the transit delay but 
a higher bandwidth is required on ATM. In partial fill mode, it is possible to configure the number of E1 
frames per cell, and to disable the AAL1 structure pointer. 


The CES can be offered on a serial interface for an nx64Kbps bit rate (64Kbps to 2048 Kbps). The AAL1 
cell format is identical to the structured mode (nx64Kbps) or unstructured mode (2048Kbps). The 
Command & Indication (C&l or 105/109) signals can be optionally transmitted: the Command signal 
enables the transmit flow; the Indication state is defined by the AAL1 synchronization state. 


ATM bandwidth required (no partial fill mode): 


























E1 Rate Pa etal Max Delay (bit/second) 
64 73 18 

128 145 11 

256 289 9 

512 578 8.5 

1024 1156 8 

1920 2167 8 

2048 2311 8 

















The Max delay is "one-way" and end-to-end with two ONE200 devices, with a jitter configured at 4 ms 
(vtoa-connection) for 128kbps to 2048kbps and 8 ms for 64Kbps E1 rate. The ATM and DSL delays are 
not included in the calculation. 


Note: There is no consistency check between the configured PCR for the ATM PVC and the bandwidth 
required for AAL1. If the PCR is too low, cells will be lost on the uplink. 


3.1.3 Synchronization 


It is necessary to synchronize the OneOS-based voice-capable router to a clock retrieved from the voice 
gateway. If the correct synchronization is not achieved, problems may occur specifically for Modem/FAX or 
CES communications. The voice gateway is usually connected to the switched telephone network and is 
synchronized to the PSTN clock reference. Four methods are possible: 


e From the voice cell flow received from the voice gateway (located in the CO). This method, configured 
by default, is recommended by the standard (BLES, CES). The OneOS-based voice-capable router 
selects the ATM (AAL2 or AAL1) connection according to a priority defined in configuration. 


e From the DSL clock 
e From an internal clock 


e For PRI only: On the E1 interface configured in slave mode. This case assumes that the PBX is 
connected to the PSTN (with another PRI interface) and therefore delivers a clock synchronized to the 
PSTN. 


e For serial CES only: on the clock signal received on the serial port (DTE mode). 
3.1.4 Main Parameters 


The following parameters must be known before configuring and installing the voice BLES function: 
ATM Parameters 
e —-VP identifier 
e VC identifier 
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PCR (Peak Cell Rate) guaranteed by the Local Exchange Carrier operator. If unknown, it will be 
assigned according to the number of ports as indicated above. 


Class of Service offered by the operator: VBR-rt or CBR. 


BLES Protocol 


Type and identification of the voice interfaces 
Assignment of the CID: static or dynamic with ELCP 
ATM profile for each voice port 


Independent or slave mode for the selection of the coder 


VTOA Protocol 


ATM profile for each voice port 


Independent or slave mode for the selection of the coder 


CES 


AAL1 parameters: partial fill, use of AAL1 structure pointer 


Voice Interface 


Echo cancellation: Disabled or enabled. When enabled the echo tail length must be provided. The 
echo cancellation may be turned off automatically upon detection of a Modem/FAX (configurable: the 
device can be forced not to detect modem/fax). For phone calls, it must be activated with a long tail 
length if the subscriber calls off-net, or short length, if the subscriber is connected locally. Warning: the 
echo cancellation cannot be enabled for CES. 


FAX application or modem: Assure that the configured profile supports this type of communication 
(profiles 7,8,9) or that the voice gateway can switch to G.711 when detecting FAX or modem 


Data application: Assure that the voice gateway (CO) supports this type of application in accordance 
with the BLES standard (indication in the CID allocation). 
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3.2 CONFIGURATION 


3.2.1 


Introduction 


A set of command lines (CLI), dedicated to voice service enables the configuration of all necessary 
parameters. In general, the BLES function requires the configuration of very few parameters. The OneOS- 
based voice-capable router permits the configuration of a comprehensive set of parameter in order to 
adapt to all cases depicted in the Standards. Most parameters will be set with their default values, thereby 
reducing the number of steps required to configure the device. 


The configuration includes the following main commands: 


voice-port: Physical S0/S2/FXS port. Voice processing parameters are defined such as echo 
cancellation, gain and the coding law. 


interface: Defines, for PRI/S2 and serial CES only, parameters for the E1/T1 physical level or the 
serial interface management. 


dial-peer voice: Logical internal ports. 


pots: Local voice port always associated with a physical port. It enables the configuration of protocol- 
specific parameters such as the bearer service voice/modem/data, etc. 


vmoabri: Internal SO ports connected to a remote voice gateway in BLES mode, which must be 
associated with a dial-peer voice POTS (that is in turn associated with a physical SO port). It 
configures parameters specific to the BLES standard: port identifier, profiles, ATM connection, CID. 


vmoapri: Similar to vmoabri, for S2 interface. 

vmoafxs: Similar to vmoabri, for analog interface. 

vtoaccs: It defines an E1 port handled in trunking mode. 
vtoaces: It defines an E1/T1 port processed by the CES function. 


vmoa-connection: Defines a connection to a voice gateway offering BLES service. It defines 
VP/VC, jitter and parameters of ELCP protocol. It is possible to define several VP/VC connections 
towards one or more voice gateways. 


vtoa-connection: Defines a connection to a voice gateway offering a voice over ATM service in 
trunking mode. 


voatm-transport-profile: Defines voice transport profiles. Enables the modification of 
standardized profiles or creation of a customized profile. By default, the standardized profiles are 
configured. 


pvc voiceoa (interface atm): Defines the ATM VP/VC and AAL2 parameters (e.g. 
multiplexing mode). 


The relationships between configuration items are described on the following diagram: 


Page 3.2-16 of 166 


ONEOS V4.2R5 VOICE USER GUIDE (EDITION 5) 








# dial peer/P 


# phy.port 
Physical Por 


# phyport 
Interface PRI 


Dial peer voice 


POTS profile 


# profile 

# dial peeNP 

# phy\port 

Dial peer voice 
VTOACCS 


or 
VTOACES 


The following sequence for configuration is preferred: 

1. PVC voiceoa 

interface if PRI or Serial CES 

VMOA or VTOA connection (voice application only) 
voice ports (except serial port) (voice application only) 
Dial Peer Voice POTS (voice application only) 


voatm profile (voice application only) 


B21 BR 2G): DD. 


3.2.2 Configuration Management 


Dial peer voice 
VMOAxxx 
# profile 


VOATM-transport- 


# connection 
VMOA 
Identif. 
VP/VG 


VMOA- pvc 
connection voiceoa 
VTOA- 
connection 


# connection 
VTOA 


Dial Peer Voice vmoabri, vmoafxs, vmoapri, vtoaccs or vtoaces (voice application only) 


Most of the parameters may be changed and applied without rebooting the device. However, some 
parameters pertaining to the ports managed by the remote BLES voice gateway require shutting down the 
global connection to the gateway for any change. To build a new configuration, it is more efficient to copy 
the configuration samples given in this chapter into a text file (startup-config), then change the 


required parameters and download the file into the device. 


After entering configuration commands, the show voice running-config command provides the 
differences between the default configuration and the running configuration in a CLI command format. 


To save the voice configuration and transfer it to another device, it is then easy to copy and paste the 
voice configuration into a text file and insert it into the configuration file of another device. 


3.2.3 Physical Voice Ports 


The voice module of the OneOS-based voice-capable router is always designated by the number 5. Ona 
BRI module, the physical port is identified with a port number in the [0..(n-1)] range, where n is the total 


port number of the interface module (currently from 4 up to 8). 


The command for the creation of the physical port number 0 (voice module number 5 on ONE400): 


CLI (configure)> voice-port 5/0 


To enable (or disable) the echo canceller - default: enabled. - use the following command. 


CLI (voice-port)> [no] echo-cancellation 


To define the maximum tail length (‘low' is 8ms, 'medium' is 16ms, ‘high’ is 32 ms) - default 'medium' -, use 
the following command. It must be configured Medium or High if off-net calls must be supported. 
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CLI (voice-port)> [no] echo-cancellation-length {low | medium | high} 


On ONE300, 30 voice channels can only be supported if echo-cancellation low or medium is 
selected. 


To specify the conditions for automatically disabling the echo canceller - default 'not configured’ -, use the 
following command. If configured modem, the echo canceller is disabled upon detection of a 2100Hz tone 
but not re-enabled at the end of the modem session (it will be re-enabled for the next communication). If 
configured voicemodem, the echo canceller is automatically enabled at the end of the modem session. 


CLI (voice-port)> [no] echo-disable {voicemodem | modem} 


To set the output gain (dB) - default: 0 dB - and amplify the voice signal sent to the voice gateway: 


CLI (voice-port)> output-gain <gain> 


To set the input gain (dB) - default: 0 dB - and amplify the voice signal received from the voice gateway: 


CLI (voice-port)> input-gain <gain> 


To select the synchronization input (aal2, aall, free-run, dsl, pri) - default: aal2 -: 








CLI (voice-port) > clock-source {aal2 |aall | free-run | dsl | pri} 
When ds1 or pri is selected, a second parameter indicates the port. The modification is automatically 
applied to all voice ports as a unique clock source must be used. 


To define the ring signal parameters, for analog ports only, use the following command. The frequency 
used is compliant to the listed countries specifications (note that the timing parameters - ringing and 
silence periods - are not used). The ringing state is directly done by the CO in CAS mode. 


CLI (voice-port)> ring {France | Germany | USA | Italy | Spain | UK | 
userdefined} 
To define the ringing parameters for the userdefined ringing profile, use the following command. Only 
the frequency is significant (the timing parameters are defined by the CO in CAS mode). 


CLI (voice-port)> user-ring <parameter list> 


To define the ringing voltage, for analog ports only, use the following command (default: normal). 





CLI (voice-port)> ring-level { normal | high | max } 


See 4.2.3.6 for more information about the available ring levels. 
Example: 


> output-gain 7 

> ring-level max 

> user-ring 55 1000 1000 1000 1000 
> ring userdefined 


CLI (voice-port) 
CLI (voice-port) 
CLI (voice-port) 
CLI (voice-port) 





3.2.4 PRI Interface 


If a PRI interface is used, it must be enabled by entering the following commands that allow specifying 
several parameters for the physical level. 


Example of commands for enabling an E1 interface on physical port number 0 (voice module number 5): 


CLI (configure)> interface pri 5/0 
CLI (config-if)> physical-interface El 
CLI (config-if)> linecode hdb3 





Main parameters: 
To specify the interface type of voice interface as E1 or T1 - default: E1 -: 


CLI (config-if)> physical-interface { E1 | T1 } 
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To specify the framing type: 


CLI (config-if)> framing { none | df | mf | emf | sf | esf | auto-detect } 


e none: no framing. Only used for CES / unstructured mode 
e df: double frame (no CRC4). For E1 only. (Default value) 
e mf: multiframe (CRC4). For E1 only 

e emf: extended multiframe (CRC4). For E1 only 

e sf: super-frame (for T1 only) 

e esf: extended super frame (for T1 only) 


e auto-detect: used to find automatically ISDN PRI framing by trying all possible detections. This 
behavior can be set when the configuration of remote side is unknown. An event containing the 
correct framing is generated when layer-1 is activated. 


To specify the physical line coding to be used - default: hdb3 -: 

CLI (config-if)> linecode { ami | hdb3 | bz8s } 
The interface must be shut down if a physical parameter has to be modified. The interface is re-activated 
with the no shutdown command. 


CLI (config-if)> [no] shutdown 


3.2.5 Serial CES Interface 


If a serial interface is used for CES, it must be enabled by entering the following commands that specify 
several parameters for the physical level. 


Commands for enabling a serial interface on serial port number 0: 


interface serial-ces 0/0 
clock-source aall 
input-command STD tx 
output-indication STD rx 
atm-pvc VGW 

bit-rate 512000 


CLI (configure) > 
CLI (config-if)> 
CLI (config-if)> 
CLI (config-if)> 
CLI (config-if)> 
CLI (config-if)> 


Main parameters: 


To define the clock source, use the following command. serial is used if DTE mode is configured 
(detected via cable). When serial is selected and the port configured in DCE, the aali clock-source is 
automatically selected. uplink indicates that the device clock is synchronized on the physical level of the 
DSL uplink. aal1 means that the clock is recovered using the adaptive recovery method, which computes 
clock based on the AAL-1 arrival rate. free-run indicates that the clock is generated by an internal 
device clock generator. 


CLI (config-if)> clock-source {aall | free-run | serial | uplink} 


To define how to manage the C/105 signal (DCE mode) or the 1/109 signal (DTE mode), use the following 
command. The first parameter defines if the signal is forced (on, off) or not. The normal value is std 
(standard behavior); on and off are for testing purpose only. The second parameter defines how AAL1 
flow transmission is managed depending on 105 signal state. When tx is selected, AAL-1 cells are sent 
only when 105 is ON; when 105 is OFF, AAL-1 cells are not sent. When no-tx is selected, AAL-1 cells 
are sent without verifying the 105-signal state. Default value: std tx. 


CLI (config-if)> input-command {off | on | std} {tx | no-tx} 


To define how to manage the 1/109 signal (DCE mode) or the C/105 signal (DTE mode), use the following 
command. The first parameter defines if the signal is forced (on, off) or not. The second parameter defines 
how the 109 signal is managed depending on the AAL1 flow reception status. When no AAL-1 cells are 
received and the configured value is std rx, the 109 signal is forced off while no AAL-1 cells are 
received. Otherwise, the 109 signal is set on. When no-rx is selected, the 109 signal does not depend on 
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the AAL-1 reception status. Default values: std rx. 
CLI (config-if)> output-indication {off | on | std} {rx | no-rx} 
To specify the bit rate, use the following command. In DTE mode, if the received clock is different from the 
configured bit rate, error events may occur and the service will not be operational. 
CLI (config-if)> bit-rate {64000 | 128000 |....| 2048000} 
The maximum network jitter can be compensated by the OneOS-based voice-capable router (default 


30ms). The jitter command subsequently configures the jitter buffer length. The jitter buffer length is 
provided in milliseconds. 


CLI (config-if)> jitter <lenght_in_ms> 


To specify the PVC VOICEOA to be used, use the following command. 


CLI (config-if)> atm-pve <vcd> 


To disable the CES port, use the following command. This command must be used for modification of 
atm-pvc, jitter, bit-rate parameters. Use no shutdown to re-enable the CES port. 


CLI (config-if)> [no] shutdown 


Note: 


e If voice ports are also configured, the selected clock-source will be applied to all the voice and CES 
ports (there is a single clock source for all the voice and serial CES ports). 


e All the other output signals (108/107, 106) are set to ON except if the port is shutdown. 
3.2.5.1. Loopback Commands 


The loopback commands are entered when the CLI is in the serial—ces menu. To do so, enter: 


CLI (configure)> interface serial-ces 0/0 


For troubleshooting, loopback commands are used to identify, which side of the connection is faulty. 


A loopback on the serial interface returns incoming data to the serial interface output. Incoming AAL-1 cells 
are dropped and outgoing AAL-1 cells are filled with all-ones to perform trunk conditioning. The command 
for serial interface loopback is: 


CLI (configure)> loop serial 
A loopback on the ATM side returns data processed through the CES function to the incoming PVC. 


Incoming data on the serial port is dropped. Outgoing data on the serial port is a series of all-ones. The 
command for ATM CES loopback is: 


CLI (config-if)> loop atm-ces 


The no loop command removes the serial or ATM CES interface loopback. Both loopback commands 
cannot be used simultaneously. 


3.2.6 Internal Local Voice Port (POTS) 
The command for the creation of a local POTS port associated with the 5/0 physical port is: 


CLI (configure)> dial-peer voice pots 1 
CLI (pots)> port 5/0 


Each dial-peer voice pots must be identified by an arbitrary index from 1 to N. 


3.2.7 Voice over ATM PVC 


An ATM PVC must be created to support the transport of voice and signaling over ATM. The following 
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example creates a PVC with VP=2, VC=32 towards the voice gateway. The PVC is identified with an 
arbitrary name vgw and uses a CBR Class of Service with a PCR at 160000 bps. 


CLI (configure)> interface atm 0.2 

CLI (config-if)> pve voiceoa vpi 2 vci 32 vgw 
CLI (voiceoa)> qos cbr per 160000 

CLI (voiceoa)> priority 1 

CLI (voiceoa)> execute 





List of commands and parameters: 
A specific sub-interface must be defined for a voice PVC. 


CLI (configure)> interface atm <physical>.<sub-interface> 


To specify the VP/VC to be used and define the identifier used by the other voice commands. 

CLI (config-if)> pve voiceoa vpi <vpi-id> vei <vci-id> <identifier> 
To specify the Class of Service (CBR or VBR-RT) and the PCR (Peak Cell Rate) in bps, use the following 
command. The Class of Service must always be specified. 


CLI (voiceoa)> qos {cbr | vbr-rt } per <pcr-value> 


To specify the priority for transmission, use the following command. It must be set to 1 for voice PVC. 

CLI (voiceoa)> priority <priority> 
To enable the multiplexed mode for AAL2 (default: no timer-cu), use the following command. The value 
in ms is the time to wait another voice payload for multiplexing before sending the AAL-2 frame. 


CLI (voiceoa)> [no] timer-cu <milliseconds> 


To specify the ATM AAL type, use the following command (default: AAL2). 
CLI (voiceoa)> type {aall | aal2 } 


To specify the structured format for AAL1, use the following command. 
CLI (voiceoa)> structured {pf | no-pf} [length <1-47>] {pointer | no- 
pointer} 

- pf: partial fill (default: no partial fill) 


- length: is the maximum number of E1/T1 frames in each AAL1 payload (partial fill mode only). The 
default value is 1.There is no consistency check on this value: the final value will be the minimum value 
between this parameter and the possible length depending on the number of time-slots (configured in dial- 
peer voice vtoaccs). 


- pointer: is the optional AAL1 structure pointer. Mandatory if partial fill is disabled. (Default: pointer). 


To specify the unstructured mode for AAL1, use the following command. Default value: structured no- 
pf pointer. 


CLI (voiceoa)> no structured 


To specify the time-out of non cell reception to consider the AA1 connection as out of service, use the 
following command. Default: 2500 ms. 


CLI (voiceoa)> cell-loss-integ-period <1000..65000 ms> 


The following command must be entered for validation of the parameters. 


CLI (voiceoa)> execute 


Page 3.2-21 of 166 


ONEOS V4.2R5 VOICE USER GUIDE (EDITION 5) 


3.2.8 VMOA/BLES Connection 


In the following example, the VMOA connection is created and associated to the PVC identified by the 
name vow: 


CLI (configure) > vmoa-connection 1 
CLI (vmoa)> atm-pvc vgw 
CLI (vmoa) > 





The modification of some parameters requires deactivation of the connection: command shutdown when 
the prompt is CLI (vmoa) >. Then enter command no_ shutdown to activate it after modification. 


Main Parameters: 


To specify the maximum network jitter that can be compensated by the OneOS-Based voice-capable 
router, enter the following command (default 30ms). The jitter command subsequently configures the jitter 
buffer length. 





CLI(vmoa)> jitter <buffer-length-in-milliseconds> 


To enable ELCP-CAP (Channel Allocation Procedure) - default: enabled, enter the following command: 





CLI (vmoa)> les-cap {enabled | disabled} 


To enable ELCP-Control (Port Control Procedure) - default: enabled, enter the following command: 

CLI (vmoa)> les-common-control {enabled | disabled} 
To allow configuration of the mode for the voice coder selection in the profile, slave or independent - 
default: no, meaning slave mode -, enter the following command: 

CLI (vmoa) > coder-—mode-independent {yes | no} 
To select the activity detection before sending packets, use the following command. The OneOS-Based 
voice-capable router begins sending frames when it receives frames. It is recommended to configure 'yes' 


if ELCP and silence detection are not used to avoid the transmission of voice packets when the 
communication is not established. Default: no. 


CLI (vmoa)> implicit-channel-act {yes | no} 
To define the minimum time without receiving frames before deactivation of the transmission - related to 
the implicit activation -, use the following command. Default: 300ms. 

CLI (vmoa)> deactivation-timer <miliseconds> 
The VMOA connection is deactivated by default and, if activated, must be deactivated for configuration 


modification. Use the no form of the following command to activate or reactivate the VMOA connection. 
Use the following command to deactivate the VMOA connection. 


CLI (vmoa)> shutdown 


To activate or deactivate the ELCP protocol, both les-cap and les-common-control must be enabled 
or disabled. 


3.2.9 VTOA Connection 


In the following example, the VTOA connection is created and associated with the PVC identified by the 
name vgw: 


CLI (configure) > vtoa-connection 1 
CLI (vtoa)> atm-pvc vgw 
CLI (vtoa) > 


The modification of some parameters requires deactivation of the connection: command shutdown when 
the prompt is CLI (vtoa) >. Then enter command no_ shutdown to activate it after modification. 
Main Parameters: 


To specify the maximum network jitter that can be compensated by the OneOS-Based voice-capable 
router, enter the following command (default 30ms). The jitter command subsequently configures the jitter 
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buffer length. 





CLI(vtoa)> jitter <buffer-length-in-milliseconds> 
To select the activity detection before sending packets, use the following command. The OneOS-Based 
voice-capable router begins sending frames when it receives frames. Default: no. 

CLI (vtoa)> implicit-channel-act {yes | no} 
To define the minimum time without receiving frames before deactivation of the transmission - related to 
the implicit activation -, use the following command. Default: 300ms. 

CLI (vtoa)> deactivation-timer <miliseconds> 
The VTOA connection is deactivated by default and, if activated, must be deactivated for configuration 


modification. Use the no form of the following command to activate or reactivate the VTOA connection. 
Use the following command to deactivate the VTOA connection. 


CLI (vtoa)> shutdown 


3.2.10 ATM Transport Profile 


The following profiles are pre-configured (the voice packet length in bytes is given between brackets and is 
followed by the UUI ranges): 









































Ident.| Name Coder 0 Coder 1 Coder 2 eee 
0 ATM Forum n°7 | G.711 (44) 0-7 | G.726-32 (44) 8-15) - Yes 0-7 
1 ATM Forum n°8 | G.711 (44) 0-15) - = Yes 0-15 
2 ATM Forum n9 | G.711 (44) 0-15) - - No 

3 ATM Forum n°10} G.711 (44) 0-7 | G.726-32 (44) 8-15) - No 

4 ATM Forum n°11} G.711 (40) 0-7 | G.726-32 (40) 8-15) - No 

5 ATM Forum n°12} G.711 (40) 0-7 | G.726-32 (40) 8-15) - Yes 0-7 
6 ITU 1366.2 n° G.711 (40) 0-15) - = No 

7 ITU 1366.2 n°2 G.711 (40) 0-15) - - Yes 

8 ITU 1366.2 n°13 | G.711 (40) 0-7 | G.726-32 (40) 8-15) G.726-32 (20) 8-15] Yes 0-15 
9 Specific CES-44 | CES (44) 0-15 | - - No 

10 Specific CES-40 | CES (40) 0-15 | - - No 























The coder by default is coder 0. When in independent mode it is possible to select another coder by 
modifying the standardized profile. It is also possible to create a new profile identical to one of the 
standardized profiles but with the coder by default different from 0. 


Example of a profile identical to ATM Forum n°7 with G.726 as default coder instead of G.711: 
CLI (configure) > voatm-transport-profile 3 
CLI (voatm-trans)> coder-profile ATMF7 1 a-law 

Parameters: 
CLI (voatm-trans)> coder-profile <profile-id> <index> <coding-law> 


profile-id indicates the profile to be used (ATMFx or userdefined), index specifies the coder to be 
used, coding-law specifies a—-law or u-law in case of G.711. 





To enable silence detection on the transmitted flow (phone to voice gateway) - if the selected profile allows 
it -, use the following command. If vad is configured, simple silence packets are sent. If vadcng is 
configured, the received noise level is indicated in the silence frames. Default: disabled. To disable silence 
detection, use the no silence-detection command. 


CLI (voatm-trans) > silence-detection {vad | vadcng} 
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To create a specific profile, the userdefined profile must be selected. The coders are configured with 
the user-coder command. For example: 


(=) 


LI 
CLI 
CLI 
CLI 


configure)> voatm-transport-profile 4 
voatm-trans)> coder-profile userdefined 1 
voatm-trans)> user-coder 0-3 g71la-64 5500 5500 1 
voatm-trans)> user-coder 4-7 g726-32 11000 5500 1 








CLI> user-coder <UUI-range> <coder> <packet-time> <seq-number-interval> 
<M (nb-of-SDU/packet) > 


The command parameters are: 
e UUI range: Specifies the UUI range for this coder (0-3,4-7,7-11,11-15,0-7,8-15,0-15) 


e coder: g711generic-64, g711a-64, g711u-64, g726-32, g726-40, SID. If g711generic-64 is selected, 
the coding law (a-law / u-law) must be configured in the coder-profile command. SID is used for the 
silence packets. 


e packet-time: Period for each voice packet in us (ex 5500 for 5.5 ms) 





e seq-number-interval: Time between each sequence number 
e <mM>: Number of SDU in each packet. 


The index value for the coder is determined automatically while configuring the user-coder command (the 
first user-coder entered is number 0, the following user coder entered is number 1). To modify one of the 
coders, the command no user-coder must be entered (warning: all the coders will be deleted). 


For more details about the profile parameters, read the ATM Forum standard AF-VMOA-145 Annex A. 
3.2.11 Internal VMOA BRI Port 


An internal VMOA BRI port is created and is referenced with an arbitrary number that starts from one to N 
(N=number of ports). 


A "dial-peer voice POTS" is associated with the VMOA BRI port. This operation associates a port to the 
voice gateway with a local port linked to a physical voice port. 


The creation of a VMOA ISDN port is as follows: 


CLI 
CLI 
CLI 
CLI 


configure)> dial-peer voice VMOABRI 1 
vmoabri)> dial-—peer-voice-pots 1 
vmoabri)> vmoaport 1 

vmoabri)> vmoa-connection-id 1 


Commands and Parameters: 
To specify the identifier of the associated local port (mandatory): 


CLI (vmoabri)> dial-peer-voice-pots <port> 


To specify the standardized BLES port number in accordance with the CO-IWF (mandatory): 


CLI (vmoabri)> vmoaport <bles-—port-—number> 


To specify the ATM/VMOA connection identifier (mandatory): 


CLI (vmoabri)> vmoa-connection-id <cid-value> 


To define the ATM profile to be used (default: 0): 


CLI (vmoabri)> voatm-transport-profile <profile-index> 


To define the Channel ID for the D channel if ELCP is deactivated (default port nb+127): 


CLI (vmoabri)> cid-d <cid-d-value> 


To define the Channel ID for B1 channel if ELCP is deactivated (default (port nb-1)x2+160): 


CLI (vmoabri)> eid-b1l <cid-bl-value> 





To define the Channel ID for B2 channel if ELCP is deactivated (default (port nb-1)x2+161): 
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CLI (vmoabri)> cid-b2 <cid-b2-value> 
The following command is used for port blocking according to the BLES standard (if ELCP is used). The 
port is unblocked using the no shutdown command. 


CLI (vmoabri)> [no] shutdown 
Warning: If a parameter must be modified, the associated VMOA connection must be shut down first. 
3.2.12 Internal VMOA PRI Port 


An internal VMOA PRI port is created and is referenced with an arbitrary number that starts from one to N 
(N=number of ports). 


A “dial-peer voice POTS" is associated with the VMOA PRI port. This operation associates a port to the 
voice gateway with a local port linked to a physical voice port. 


The creation of a VMOA PRI port is as follows: 


CLI 
CLI 
CLI 
CLI 


configure) > dial-peer voice VMOAPRI 1 
vmoapri)> dial-peer-voice-pots 1 
vmoapri)> vmoaport 1 

vmoapri)> vmoa-connection-id 1 


Commands and parameters: 
To specify the identifier of the associated local port (mandatory): 


CLI (vmoapri)> dial-peer-voice-pots <port> 


To specify the standardized BLES port number in accordance with the CO-IWF (mandatory): 


CLI (vmoapri)> vmoaport <bles-—port-number> 


To specify the ATM/VMOA connection identifier (mandatory): 


CLI (vmoapri)> vmoa-connection-id <cid-value> 


To define the ATM profile to be used (default: 0): 





CLI (vmoapri)> voatm-transport-profile <profile-index> 
The following command is used for port blocking according to the BLES standard (if ELCP is used). The 
port is unblocked using the no shutdown command. 


CLI (vmoapri)> [no] shutdown 


Warning: If a parameter must be modified, the associated VMOA connection must be shut down first. 


ELCP must be used on the corresponding VMOA connection. It is then impossible to specify any fixed CID 
for the D and B channels. 


3.2.13 Internal VTOA CCS Port 


An internal VTOACCS (E1) port is created and is referenced with an arbitrary number that starts from one 
to N (N=number of ports). A "dial-peer-voice-pots" is associated with the VTOACCS port. This operation 
associates a port to the voice gateway with a local port linked to a physical voice port. 


The creation of a VTOACCS port is as follows: 
CLI (configure) > dial-peer voice VTOACCS 1 
CLI (vtoaccs)> dial-peer-voice-pots 1 
CLI (vtoaccs)> vtoa-connection-id 1 
Commands and Parameters: 
To specify the identifier of the associated local port (mandatory); the local port must be PRI: 


CLI (vtoaccs)> dial-peer-voice-pots <port> 
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To specify the ATM/VTOA connection identifier (mandatory): 


CLI (vtoaccs)> vtoa-connection-id <cid-value> 


To define the ATM profile to be used (default: 0): 

CLI (vtoaccs)> voatm-transport-profile <profile-index> 
To define a CID for a time slot (1 to 31) and the type (voice or signaling), - only one time slot with a 
signaling type may be configured -: 

CLI (vtoaccs)> cid <timeslot> {sig | voice} <cid-value> 
The following command is used for port blocking according to the BLES standard. The port is unblocked 
using the no shutdown command. 


CLI (vtoaccs)> [no] shutdown 


Warning: If a parameter must be modified, the associated VTOA connection must be shut down first. 


3.2.14 Internal VTOA CES Port 


An internal VTOACES (E1/T1) port is created and is referenced with an arbitrary number that starts from 
one to N (N=number of ports). A "dial-peer-voice-pots" is associated with the VTOACES port. In this 
operation, a port to the voice gateway or ATM switch is associated with a local port linked to a physical 
voice port. 


The creation of a VTOACES port is done as follows: 


CLI (configure)> dial-peer voice VTOACES 1 
CLI (vtoaccs)> dial-peer-voice-pots 1 
CLI (vtoaccs) > vtoa-connection-id 1 


Commands and Parameters: 
To specify the identifier of the associated local port (mandatory); the local port must be PRI: 


CLI (vtoaccs)> dial-peer-voice-pots <port> 


To specify the ATM/VTOA connection identifier (mandatory): 
CLI (vtoaccs)> vtoa-connection-id <cid-value> 
To specify a time slot range of the E1/T1 interface, use the following command. Several ts commands can 


be specified (e.g. 1-8, 16-23...). For one time slot only, ts max is optional. These parameters are ignored 
if the unstructured mode is selected in the AAL1 PVC. 


CLI (vtoaccs)> ts <ts min> [<ts max>] 
The following command is used for port blocking according to the BLES standard. The port is unblocked 
using the no shutdown command. 


CLI (vtoaccs)> [no] shutdown 


Warning: If a parameter must be modified, the associated VTOA connection must be shut down first. 
3.2.14.1_ Loopback Commands 


The loopback commands are entered when the CLI is in the E1 CES menu. To do so, enter: 


CLI (configure)> dial-peer voice VTOACES 1 


For troubleshooting, loopback commands are used to identify, which side of the connection is faulty. 


A loopback on the PRI interface returns incoming data to the PRI interface output. Incoming AAL-1 cells 
are dropped and outgoing AAL-1 cells are filled with all-ones to perform trunk conditioning. The command 
for PRI interface loopback is the following - the no form removes the PRI interface loopback -: 


CLI(vtoaccs)> [no] loop pri 
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A loopback on the ATM side returns data passing through the CES function to the incoming PVC. 
Incoming data on the PRI interface is dropped. Outgoing data on the PRI interface is a series of all-ones. 
The command for ATM CES loopback is the following - the no form removes the ATM CES loopback -: 


CLI (vtoacss)> loop atm-ces 


Both loopback commands cannot be used simultaneously. 


3.2.15 Internal VMOA FXS Port 


An internal VMOA FXS port is created and is referenced with an arbitrary number that starts from one to N 
(N=number of ports). 


A "dial-peer voice POTS" is associated with the VMOA FXS port. This operation associates a port to the 
voice gateway with a local port itself linked to a physical voice port. 


The creation of a VMOA FXS port is as follows: 


CLI (configure)> dial-peer voice vmoafxs 1 
CLI (vmoafxs)> dial-peer-voice-pots 1 
CLI (vmoafxs)> vmoaport 1 
CLI (vmoafxs)> cid 16 
( )> 


CLI (vmoafxs vmoa-connection-id 1 


Commands and parameters: 
To specify the identifier of the associated local port (mandatory): 


CLI (vmoafxs)> dial-peer-voice-pots <port> 


To specify the standardized BLES port number in accordance with the CO-IWF (mandatory): 


CLI (vmoafxs)> vmoaport <bles-—port-—number> 


To specify the ATM/VMOA connection identifier (mandatory): 


CLI (vmoafxs) > vmoa-connection-id <cid-value> 


To define the ATM profile to be used (default: 0): 


CLI (vmoafxs)> voatm-transport-profile <profile-index> 


To define the channel id: 


CLI (vmoafxs)> cid <cid-value> 


The following command is used for port blocking. The port is unblocked using the no shutdown 
command. 


CLI (vmoafxs) > shutdown 


Warning: If a parameter must be modified, the associated VMOA connection must be shut down first. 
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3.3 CONFIGURATION EXAMPLE 


3.3.1 


BLES example 


! ATM PVC configuration 
interface atm 0.2 

pvc voiceoa vpi 2 vci 32 VGW 
gos cbr per 150000 

execute 

exit 

exit 


! Physical voice ports declaration 
voice-port 5/0 

exit 

voice-port 5/1 

exit 

voice-port 5/2 

exit 

voice-port 5/3 

exit 


! local voice ports 











dial-peer voice POTS 0 
port 5/0 

exit 

dial-peer voice POTS 1 
port 5/1 

exit 

dial-peer voice POTS 2 
port 5/2 

exit 

dial-peer voice POTS 3 
port 5/3 

exit 





! BLES connection configuration (disabled by default) 
VMOA-connection 0 

atm-pvc VGW 

jitter 30 

les-common-control 

les-cap 

exit 


! Voice over ATM profile configuration 
VOATM-transport-profile 0 

coder-profile coder-profile ATMF7 1 a-law 
exit 





! BLES ports configuration 
dial-peer voice VMOABRI 0 
VMOAport 1 
VOATM-transport-profile 0 
dial-peer-voice-POTS 0 
VMOA-connection-id 0 


To use these configuration examples, copy & paste the following commands lists in a configuration file or 
to the CLI. 


The complete configuration for 4 SO ports over a VP/VC=2/32 and ATM profile #7 with ELCP is the 
following: 
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exit 

dial-peer voice VMOABRI 1 
OAport 2 
OATM-transport-profile 0 
ial-peer-voice-POTS 1 
OA-connection-id 0 


* 
on 
at 


ial-peer voice VMOABRI 2 
OAport 3 
OATM-transport-profile 0 
ial-peer-voice-POTS 2 
OA-connection-id 0 

xit 
ial-peer voice VMOABRI 3 
OAport 4 
VOATM-transport-profile 0 
dial-peer-voice-POTS 3 


seenogsecssergendsg 











! Enabling the BLES connection 
VMOA-connection-id 0 

no shutdown 

exit 

exit 


3.3.2 VTOA Example 


Configuration of a full E1 in trunking mode over the VP/VC 2/46, coder G726+VAD, time-slot 16 used for 
signaling: 


! ATM PVC configuration 
interface atm 0.1 

pve voiceoa vpi 2 vci 46 PARIS 
qos cbr per 2304000 

priority 1 

execute 

exit 

exit 


! Physical voice port declaration 
voice-port 5/0 
exit 


! PRI interface parameters 
interface pri 5/0 

linecode hdb3 
physical-interface El 

exit 





! local voice ports 
dial-peer voice POTS 0 
port 5/0 

exit 


! VTOA connection configuration (disabled by default) 
VTOA-connection 0 

atm-pvc PARIS 

jitter 30 

exit 


! Voice over ATM profile configuration 
voatm-transport-profile 0 
coder-profile atmf8 1 a-law 
silence-detection vadcng 

exit 





! VTOACCS port configuration 
dial-peer voice vtoaccs 0 
voatm-transport-—profile 0 
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vtoa-connection-id 0 
dial-peer-voice-pots 0 











cid 1 voice 160 
cid 2 voice 161 
cid 3 voice 162 
cid 4 voice 163 
cid 5 voice 164 
cid 6 voice 165 
cid 7 voice 166 
cid 8 voice 167 
cid 9 voice 168 
cid 10 voice 169 
cid 11 voice 170 
cid 12 voice 171 
cid 13 voice 172 
cid 14 voice 173 
cid 15 voice 174 
cid 16 sig 128 
cid 17 voice 175 
cid 18 voice 176 
cid 19 voice 177 
cid 20 voice 178 
cid 21 voice 179 
cid 22 voice 180 
cid 23 voice 181 
cid 24 voice 182 
cid 25 voice 183 
cid 26 voice 184 
cid 27 voice 185 
cid 28 voice 186 
cid 29 voice 187 
cid 30 voice 188 
exit 


! Enabling the VTOABLES connection 
vtoa-connection 0 

no shutdown 

exit 

exit 


3.3.3 CES Example 


Configuration of an E1 in structured mode over the VPl=2/VCI=46, time slot 1 to 31. 


! ATM PVC configuration 
interface atm 0.1 

pve voiceoa vpi 2 vci 46 PARIS 
gos cbr per 2304000 

type aall 

structured no-pf 

priority 1 

execute 

exit 

exit 


! Physical voice port declaration 
voice-port 5/0 

clock-source aall 

exit 


! PRI interface parameters 
interface pri 5/0 

linecode hdb3 
physical-interface El 

exit 





! local voice ports 
dial-peer voice POTS 0 
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port 5/0 
exit 


! VTOA connection configuration (disabled by default) 
VTOA-connection 0 

atm-pvc PARIS 

jitter 5 

exit 


! VTOACES port configuration 
dial-peer voice vtoaces 0 
vtoa-connection-id 0 
dial-peer-voice-pots 0 

ts 1 31 

exit 





! Enabling the VTOA connection 
vtoa-connection 0 

no shutdown 

exit 

exit 
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3.4 STATISTICS AND CONFIGURATION DISPLAY 


The Command Line Interface provides access to statistics and configuration status for the voice service. 
The show command can be used at any level in the CLI tree. 


The syntax is the following: 


CLI> show voice <parameters> <index> 


parameters defines the port or the connection 


index specifies the port or connection number; all specifies all ports or connections. 
3.4.1 Running Configuration 


The command show voice running-config provides the current voice configuration with a list of CLI 
commands that are the exact differences between the current configuration and the default configuration. 
This command enables easy replication of configuration over other devices. 


This set of commands can be entered in another device to set up the voice service with the same 
parameters. First, it is preferable to use the voice-default CLI command to ensure that the device 
starts with the same default configuration. 


CLI> show voice running-config 
Building configuration... 
voice-default 

vmoa-connection 0 

atm-pvc paris 

jitter 30 

les-cap 

les-—common-control 

exit 
voatm-transport-—profile 0 

coder-profile userdefined 0 a-law 
user-coder 0-3 g7lligeneric-—64 5000 5000 1 








exit 

dial-peer voice pots 1 
port 5/0 

exit 


dial-peer voice vmoabri 0 
dial-peer-voice-pots 0 
vmoa-connection-id 0 
vmoa-port 1 
voatm-transport-—profile 0 
exit 
dial-peer voice vmoabri 1 
dial-peer-voice-pots 1 
vmoa-connection-id 0 
vmoa-port 2 
voatm-transport-—profile 0 
exit 
dial-peer voice vmoabri 2 
dial-peer-voice-pots 2 
vmoa-connection-id 0 
vmoa-port 3 
voatm-transport-—profile 0 
exit 
dial-peer voice vmoabri 3 
dial-peer-voice-pots 3 
vmoa-connection-id 0 
vmoa-port 4 
voatm-transport-—profile 0 
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exit 
vmoa-connection 0 
no shutdown 

exit 

CLI> 


3.4.2 Voice Hardware and Software versions 


To show the voice hardware configuration enter: 


CLI> show voice hardware full 





Voice module : 6 lines 
otherBoard : 2 BRI 
Ext Module : MF100 
: 4 FXS 


To show the voice software version enter: 


CLI> show voice version 
Voice VOIP version: _V27 (02/01/09 21:14:12) 
Voice DSP version: 40533 


3.4.3 BRI/SO Voice Port Statistics 


The command to display statistics on a BRI voice port is (in this example, voice port number 0): 


CLI> show voice voice-port bri index 0 
voice port 5/0 

protocol descriptor BRI_NT 

current state activated 

config state up 

layer 1 status activated 

attached vmoabri dial peer 0 

number of voice communication 0 

bri Tx frames on D channel 40 

bri Rx frames on D channel 41 


Notes: 
e The Layer 1 state (layer 1 status) may be deactivated if no communication is in progress. 


e Number of voice communications: 0, 1 or 2. Current number of B channel with compression enabled. 


e show voice voice-port bri all displays statistics on all the voice ports. 
3.4.4 FXS Voice Port Statistics 


To show statistics on a FXS physical port, enter: 


CLI> show voice voice-port fxs index 0 
voice port 5/0 

current state on hook 

config state up 

attached vmoa fxs dial peer 0 

voice communication no 


Notes: 
e Voice communication is indicated as "yes" if the voice path is activated. 


e ‘show voice voice-port fxs all’ displays statistics on all the voice ports. 
3.4.5 PRI Voice Port Statistics 


The following command returns statistics about the physical E1/PRI port. 


CLI> show voice voice-port pri index 0 
voice port 5/0 

physical type El 

protocol descriptor E1_PRI 
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current state activated 

config state up 

layer 1 status deactivated 
number of voice communications 0 
pri AIS occurence 0 

pri RDI occurence 0 


Notes: 
e The "number of voice communications" is the number of current established voice paths. 


e ‘show voice voice-port pri all’ displays statistics on all the voice ports 
3.4.6 BLES BRI Voice Port 


The following statistics are specific to the internal port voice BRI connected to voice gateway (CO). 
The used command (e.g. for VMOABRI number 0) is: 


CLI> show voice dial-peer voice vmoabri index 0 
dial-peer 0 

attached physical port 5/0 
current state activated 
config state up 

port status unblocked 
blocking occurrence 0 
total blocking duration 0 
B-channel allocation number 0 
total B-chn alloc. duration Oh Om Os 
Bl channel 

current state deallocated 
current Tx coder none 
current Rx coder none 
current BC voice 

current CID none 

voice packet send 0 

voice packet received 0 

B2 channel 

current state deallocated 
current Tx coder none 
current Rx coder none 
current BC voice 

current CID none 

voice packet send 0 

voice packet received 0 

D channel 

current state allocated 
current CID 128 

voice frames send 40 

voice frames received 41 











Notes: 
e Current BC: (Bearer Capability) voice or voiceband data orunrestricted 


e Blocking occurrence: Number of "block" commands received from the CO (when using ELCP) 





e ‘show voice dial-peer voice vmoabri all’ displays statistics on all the BLES ports 
3.4.7 BLES FXS Port Statistics 


The following command returns statistics on a dial peer VMOAFXS port: 


CLI> show voice dial-peer voice vmoafxs index 2 
dial-peer 2 

attached physical port 5/2 

current state up 

current Tx coder g7llgeneric—64 

current Rx coder g7/llgeneric-—64 

current BC voice 
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current CID 18 
voice packet send 1314 
voice packet received 1307 





Note: 





e ‘show voice dial-peer voice vmoafxs all’ displays statistics on all the BLES ports 


3.4.8 BLES PRI Port Statistics 


The following command returns statistics about a BLES PRI port: 


CLI> show voice dial-peer voice vmoapri index 0 
dial-peer 0 

attached physical port 5/0 

port status unblocked 

current. state. up 

config state up 

B-channel allocation number 4 

total B-chn alloc. duration Oh Om Os 
D channel 

current state allocated 

current CID 128 

voice frames send 134 

voice frames received 97 

Allocated B channels 








Time- cate- Tx Rx BC CID Packets 
slot gory coder coder sent received 











1 voice g7lla g71lla voice 160 2300 2280 
4 voice g7lla g7lla voice 167 4560 4575 
7 voice g7lla g7lla voice 165 6765 6770 
17 voice g7lla g7lla voice 163 8785 8780 


Notes: 
e BC: (Bearer Capability) voice of voiceband data or unrestricted 


e Blocking occurrence: number of "block" commands received from the CO (when using ELCP) 





e ‘show voice dial-peer voice vmoabri all’ displays statistics on all the BLES ports 


3.4.9 VTOA-CCS Port Statistics 


The following command returns statistics about the VTOA-CCS port and for each time-slot: 


CLI> show voice dial-peer voice vtoaccs ind 0 
dial-peer 0 

attached physical port 5/0 

current state up 

config state down 

Time-Slot 








Time- cate- Tx Rx CID Packets 
slot gory coder coder sent received 











1 voice g7lila g7lla 16 0 0 
2 voice g7lla g7lla 17 0 0 
16 sig none none 18 0 0 


3.4.10 VTOA CES Port Statistics 


The following command provides statistics for the VTOA-CES port: 


CLI> show voice dial-peer voice vtoaces ind 0 
dial-peer 0 

attached physical port 

current state up 

config state up 
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Notes: 


aall statistics: 

syncro state up 

out-of-sync occurences 1 
transmitted cells 400479 
received valid cells 312603 
rx overflows 0 

rx underrun 1 

rx invalid pointers 0 

rx cre error 0 

rx cell loss 1 


e synchro state? is 'up' if a correct AAL1 cell is received. It is 'down' when no correct cell is received 


during the time configured cell—loss-integ-period. 





e  Animportant value of rx underrun may indicate that the jitter is greater that the value configured in 
vtoa-connection 


3.4.11 BLES/VMOA Connection 


The following command provides global statistics about the connection (e.g. connection 0) with the voice 
gateway (CO): 


Notes: 


e aal2 ssted: Transports ISDN signaling frames (D Channels) and ELCP/V5 frames. 


CLI> show voice vmoa-connection index 0 
vcd connection (line, vp, vc) 0, 0, 38 
atm vc current state activated 

atm vc config state up 

atm vc failure occurrences 0 

atm vc total failure duration 0 

v5pstn 

current established voice path 0 
outgoing voice path est. req. 0 
incoming voice path est. req. 0 

elcp 

total successful allocations 4 

total unsuccessful allocations 0 




















total allocation duration 0 
lapv5 

current state established 

number of Rx frames 924 

number of Tx frames 929 

number of Rx I frames 30 

number of Tx I frames 30 

number of Rx REJ frames 0 

number of Tx REJ frames 0 

number of Rx RNR frames 0 

number of Tx RNR frames 0 

number of T200 expirations 5 
aal2 ssted 

number of frames received 821013 
number of frames sent 823093 
frames received and discarded 19775 
frames received with errors 0 
frames sent and discarded 0 


e  lapv5: Transports ELCP and V5 PSTN frames. 


3.4.12 VTOA Connection 


The following command returns statistics about a VTOA connection (VC status, AAL2 flows): 


CLI> show voice vtoa-connection index 0 
Ved connection 0, 2, 46 
atm Vo current. state up 
atm vc config state up 
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atm vce failure occurrences 0 
atm vce total failure duration 0 
aal2 ssted 

number of frames received 0 
number of frames sent 0 


3.4.13 Event Display 


The voice service generates events or log messages: warnings, errors or informational messages. 


To view the messages on the CLI interface enter: 


CLI> event filter add vox all MEM 
CLI> monitor event 





Events list 


Layer 1 on ISDN BRI port <5/x> <activated or deactivated>: ISDN layer 1 state (info) 


Layer 1 Error on ISDN BRI port <5/x> <activation failure / deactivation>: ISDN layer 1 
error. Can indicate that the ISDN line is disconnected. 


Layer 1 on E1/T1 port <5/x> <activated or deactivated>: G703/G704 state on PRI port 


Alarm on E1/T1 port <5/x> <LOS, AI, RAI, End of LOS, End of AI, End of RAI>: 
Alarm detected on PRI port (compliant to G704). 











FXS port <off-hook>, <on-hook>, <ringing on>, <ringing off>: Event on FXS analog port. 


Voice port <5/x> status change: <shutdown / no shutdown>: Indicates that the interface 
has been shutdown by the operator. The port cannot be used for calls. 


Connection to BLES voice gateway <vcd> established: If ELCP is used; it indicates that the 
RESTART procedure with the remote BLES gateway is successful (LAPv5 established). 


Connection to BLES voice gateway <vcd> failure - <cause of failure>: If ELCP is 
used, it indicates that the RESTART procedure has failed. 


VoATM VP/VC <vcd> status change: <shutdown / no shutdown / ready / 
disconnected>: Indicates the state of the ATM VCC used to access to the voice gateway. 


VMOA port <vcd:VMOA port> status change <blocked/unblocked> by <vgw/user>: Indicates 
that a "block "unblock" command has been received (from the gateway or with a shutdown/no 
shutdown command on VMOA port). 


ISDN VMOA port <vcd:VMOA port> D-Channel allocated (CID: <cID>): The D channel is allocated 
by the voice gateway. Voice calls are possible on the ISDN port. 


ISDN VMOA port <vcd:VMOA port> D-Channel de-allocated (CID: <cID>): The D channel is de- 
allocated by the voice gateway. Voice calls are no longer possible on the ISDN port. 


ISDN VMOA port <vcd:VMOA port> B-channel <B1..B30> allocated (CID: <CID>, Type: 
<voice/data>): Indicates that the B channel is established (voice coding enabled). 


ISDN VMOA port <vcd:VMOA port> B-channel <B1..B830> de-allocated: Indicates that the B 
channel is disconnected (end of voice call). 


VMOA port <vcd: VMOA port> allocation failure <cause>: Indicates an internal error while allocating 
a channel. This can be due to a lack of DSP resource. 


<number> Voice packet lost on CID <vcd> <cid>: Indicates packet loss on the received flow. 


<number> Excessive Jitter on CID <vcd> <cid>: Indicates that the jitter is greater than the 
configured value (vmoa/vtoa connection). 


FAX/Modem detected on CID <vcd> <cid>: Indicates that a FAX/modem is detected, which allows 
the disabling of the echo canceller. 


End of FAX/Modem on CID <vcd> <cid>: Indicates a return to voice mode (the echo canceller is 
enabled again). 
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e Voice coder <coder><transmitting/receiving> on CID <vcd> <cid>: Indicates the voice 
coder currently used. 


e  =DSP failure <dsp number> <cause of failure> Indicates a DSP internal error (software crash). 


e <number> Invalid voice packets received: Indicates that invalid voice packets have been received. 
This event may be due to a wrong ATM voice profile. 


e Voice activation <false / true>on CID <vcd> <cid>: Voice activation in implicit mode. Mainly 
used for FXS in CAS mode, while ELCP is not supported. 


e System clock is synchronized on AAL2 clock on CID <vcd> <cid>: The adaptive clock recovery 
system is operational and works on the indicated CID. 


e No sync clock. Fallback to free run clock: The adaptive clock recovery system has not detected a valid 
incoming AAL2 flow. 


e Sync clock is back.: The adaptive clock recovery system has detected a valid incoming AAL2 flow and 
is operational. 


e AAL2 clock differs from system clock on CID <vcd> <cid>: Potential synchronization problem 
detected by the adaptive clock recovery system. 


e AAL1 synchronized on VP/VC <vcd>: normal AA1 cell flow received. 
e AAL1 out of synch on VP/VC <vcd>: incorrect cell received during a specified delay. 


e <number> Excessive Jitter on AA1 VP/VC <vcd>: the jitter is greater than the configured value (see 
vtoa-connection). 


e  <number> Invalid cells received on AA1 VP/VC <vcd>: invalid AAL1 cells have been received. 
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3.5 DEBUG TOOLS 


3.5.1 ELCP protocol capture 


It is possible to have a complete trace of all the ELCP protocol messages exchanged between the OneOS- 


based voice-capable router and the CO on CID 8. 


On the CLI point of view, it relies on the logging command principle, already available for ip debugging. 


Enter the following command: 


CLI> debug v5 <vmoa connection id> 


Example: 
CLI>debug v5 0 















































09:06:43.062 Cpe:0 Ll frame sent. 

09:06:43.062 Cpe:0 L2 tx SABME P/F=1 C/R=0. 
09:06:43.063 hex: OO O1 7f 

09:06:43.085 Cpe:0 Ll frame received. 

09:06:43.085 Cpe:0 L2 rx UA P/F=1 C/R=0. 

09:06:43.085 hex: OO O01 73 

09:06:49.525 Cpe:0 Ll frame received. 

09:06:49.525 Cpe:0 L2 rx INFO P=0 NR=0 NS=0 C/R=1. 
09:06:49.526 hex: 02 01 00 00 

09:06:49.526 Cpe:0 L3 rx ALLOC (cid=129) bccref:0x4020. 
09:06:49.526 hexl: 48 40 20 20 40 02 00 05 41 01 80 48 O01 81 
09:06:49.527 Cpe:0 Ll frame received. 

09:06:49.527 Cpe:0 L2 rx INFO P=0 NR=0 NS=1 C/R=1. 
09:06:49.527 hex: 02 01 02 00 

09:06:49.527 Cpe:0 L3 rx ALLOC (cid=128) bccref:0x4021. 
09:06:49.527 hexl: 48 40 21 20 40 02 00 03 41 01 80 48 O01 80 
09:06:49.531 Cpe:0 Ll frame sent. 

09:06:49.531 Cpe:0 L2 tx RR P/F=0 NR=1 C/R=1. 
09:06:49.531 hex: 02 01 01 02 

09:06:49.532 Cpe:0 Ll frame sent. 

09:06:49.532 Cpe:0 L2 tx RR P/F=0 NR=2 C/R=1. 
09:06:49.532 hex: 02 01 01 04 

09:06:49.538 Cpe:0 Ll frame sent. 

09:06:49.538 Cpe:0 L2 tx INFO P=0 NR=2 NS=0 C/R=0. 
09:06:49.538 hex: 00 01 00 04 

09:06:49.538 Cpe:0 L3 tx ALLOC COMP bccref:0x4020. 
09:06:49.538 hexl: 48 40 20 21 

09:06:49.539 Cpe:0 Ll frame sent. 

09:06:49.539 Cpe:0 L2 tx INFO P=0 NR=2 NS=1 C/R=0. 
09:06:49.539 hex: 00 O01 02 04 

09:06:49.540 Cpe:0 L3 tx ALLOC COMP bccref:0x4021. 
09:06:49.540 hexl: 48 40 21 21 

09:06:49.555 Cpe:0 Ll frame received. 

09:06:49.555 Cpe:0 L2 rx RR P/F=0 NR=1 C/R=0. 
09:06:49.555 hex: 00 O01 01 02 











3.5.2 ISDN protocol capture 


It is possible to capture the ISDN signaling of the D Channel of each BRI or PRI interface. 


Please refer to 4.5.2 for more details. 
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3.5.3 LEDs 
3.5.3.1 | OneOS-based voice-capable router ONEXXO 


On the front panel, two LEDs indicate the state of the voice service: 
LED ‘Voice’: 
Green: Connection to the voice gateway OK. If ELCP is used, this state indicates that LAPv5 is 
established. For CES, it indicates that a correct AAL1 cell flow is received. 
Red: No connection with the voice gateway or AAL1 out of sync. 
Off: The voice service is not used. 
LED 'Com': 
Green: At least one voice communication is established (or a B channel allocated). 
Off: No voice communication in progress. 


On the rear panel, two LEDs are associated to each BRI port (depending on hardware): 


Green LED: 
Off: ISDN layer 1 not activated. 
On: ISDN layer 1 activated. 


Yellow LED: 
Off: No voice communication in progress. 
On: At least one voice communication established (B channel allocated). 


3.5.3.2 | ONE100/180/300 


LED 'Voice/Com': 
Green: Connection to the voice gateway OK. If ELCP is used, this state indicates that LAPv5 is 
established. For CES, it indicates that a correct AAL1 cell flow is received. 
Blinking Green: Connection to the voice gateway OK; at least one voice path is established. 
Red: No connection with the voice gateway or AAL1 out of sync. 
Off: The voice service is not used. 
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4 votcE OVER IP: SIP & H.32 3 





4.1 INTRODUCTION 


The ONE100/200/400 enables the connection of conventional telephone terminals (ISDN or analog), or 
PBXs (ISDN BRI/PRI or analog), to the PSTN through an IP network compliant with ITU-T H.323 v4 and 
SIP v2. The ONE400/200 is a voice gateway and inter-works with all the other devices in the H.323 
architecture: IP Phone, Soft Phone on PC (e.g. NetMeeting), Media Gateway, Gatekeeper & Softswitch, 
Multipoint Control Unit (MCU), Interactive Voice Response server (IVR)... 


A typical architecture for a Voice over IP network is as follows: 


Media 
Gateway 






SS7/ISUP 










| H H.323 Voice Gateway 
ONE 400 





.323 Voice Gateway 
ONE 200 


Softswitch 


Gatekeeper ISDN SO 


or FXS 


4.1.1 SIP and H.323 Overall Architecture 


The diagram below represents an overview of the VoIP software functional blocks. The diagram shows 
that the H.323 and SIP gateway function share a common set of functions. 


Page 4.1-41 of 166 


ONEOS V4.2R5 VOICE USER GUIDE (EDITION 5) 






Processing 





Details about every block: 


e Voice interfaces: they are the ports where legacy telephone devices are connected, such as PBX and 
phones. They are: 


e FXS ports 

e FXO ports 

e BRI ports: SO/TO in NT/TE mode 
e PRI port(s): NT/TE mode 


e Voice signaling: it is the processing of the ISDN signaling/analog signaling so that calls are translated 
into an internal call format. An ISDN decoder enables ISDN signaling decoding. 


e  Inbound/outbound call processing: phone number translation before/after routing, dialed number 
pattern matching to start calling in case of received overlap dialing. 


e Voice processing: the DSP software makes the voice call compression, mode/fax detection, fax 
modulation/demodulation, DTMF tone detection/generation, silence detection, echo cancellation, tone 
generation, in-band FXS caller-id generation. 


e The RTP processing is directly managed in DSP, which includes RTP frame formatting and buffering 
(dynamic jitter buffer). Having such processing embedded in the DSP software allows a more accurate 
real-time processing. 


e Fast UDP socket: tuned UDP socket for higher performance routing. 


e  SIP/H.323 call state machines: this layer manages internal call state in OneOS and maps call 
information elements into SIP/H.323 specific formats and vice-versa. 


e  SIP/H.323 stack: handle VOIP signaling for the required standard. 


e Call routing: call routing determines the output path of a received call. The output path is either a VoIP 
remote peer or a voice interface port. Local call switching is possible (call switching between two voice 
interface ports or between two VoIP peers). Backup routing permits the following: if a call fails on the 
primary route, a call attempt is placed on the backup route. Call routing can select the VoIP coding 
profile and manage number portability (availability of this feature is submitted to certain restriction). 
Call routing between the following devices is not supported: H.323 => H.323, SIP => SIP, SIP => 
H.323, and H.323 => SIP. 
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4.1.2 


4.1.2.1 


4.1.2.2 


H.323 Protocol Overview 
Signaling Processing 


The OneOS-based voice-capable router implements the H.323 protocol in conformance with: 
e ITU-T H.323 V4 "Packet-based multimedia communications systems" 


e ITU-T H.225.0 "Call signaling protocols and media stream packetization for packet-based multimedia 
communication systems" 


e ITU-T H.235 "H.323 security framework" 


ITU-T H.245 "Control protocol for multimedia communication" 
ITU-T H.323 Annex D for FAX "Real-time facsimile over H.323 systems" 


The OneOS-based voice-capable router supports the following features: 


e RAS protocol with Gatekeeper discovery, registration, admission, disengage. The RAS protocol can 
be disabled; a static routing table translating the called number in the remote H.323 device address is 
configurable (with optional number transformation). 


e H.225/Q.931 protocols for call signaling. In-bloc and overlap sending modes are both supported. 
e H.235 for authentication (RAS only). 


e H.245 protocol for media channel is supported. The fast-start (or fast connect) procedure is also 
supported to reduce the signaling traffic. 


Use of a Gatekeeper 


The OneOS-based voice-capable router supports the gatekeeper discovery, registration and admission / 
disengagement. The OneOS gateway can be authenticated by means of the H.235 protocol. 


All these parameters are configurable for discovery and registration: 


e Gatekeeper identifier: used for discovery and registration. It is generally used to identify a gatekeeper 
in charge of a local zone. 


e Gatekeeper IP address: it must be specified if the automatic discovery using RAS, multicast is not 
used. 


e H.323 identifier (also called ‘alias'): alphanumeric string identifying the OneOS-based voice-capable 
router in the gatekeeper. It can be configured globally (see h323-gateway command) and/or for each 
local port (in the routing table). 


e Gateway prefix: prefix (with optionally '#' and ™' characters) indicating to the gatekeeper that all the 
calls having the same destination number pattern must be routed to that gateway. It can be configured 
globally (see h323-gateway command) and/or for each local port (in the routing table). 


Resource Management (RAI) 


It is possible to enable the resource management using the RAI message. This feature is used by a 
Gatekeeper to manage a pool of gateways: the incoming calls are routed on the gateway, which is not 
becoming busy. Two criteria are defined and can be combined: 


e Number of time-slot, which are currently used (on enabled voice ports only). For example, a RAI 
“on” can be sent if more than 70% of the B channels of the PRI ports are used. 


e Bandwidth used (mainly for the RTP flows, depending on the voice coders). A maximum 
bandwidth that can be used by the h323 gateway is configurable. For example, a RAI message 
can be sent if more than 80% of the authorized bandwidth is used. 


Intrusive mode 


It is possible to enable a logical link between the state (layer 1) of the voice ports and the registration. This 
feature allows the gatekeeper to know if a gateway is operational before sending a call to it. Two modes 
are possible: all the voice-port must be up to start registration, one of the ports must be up to start the 
registration. The voice ports list to be checked is configurable. 


This feature also allows the PBX to know if the VoIP service is up or down: the ISDN interface physical 
layer is set at a down state if the H323 gateway is not registered. In such case, the PBX can route the calls 
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to other ISDN interfaces for backup. 
4.1.2.3 Application Cases 


e For a PBX application with BRI interfaces, a global H.323 identifier or a Gateway prefix should be 
sufficient due to PBX facilities that can switch different phone calls independent of the BRI Interface. 


e For analog ports application connecting subscribers, it could be necessary to indicate to the 
gatekeeper an E.164 number for each port. 


4.1.2.4 ISDN - H323 Signaling Gateway 
4.1.2.4.1 Dialing 


Two modes are possible: in-bloc dialing and overlap dialing. 


e The in-bloc dialing functions as follows: the complete destination number is inserted in the SETUP 
message. If a gatekeeper is used, an admission request providing the called number is sent to the 
gatekeeper that returns the IP address to be contacted for signaling. If a gatekeeper is not used, the 
called number is compared with the E.164 prefix configured in the routing table. If the called number 
matches an entry in the routing table, an H.225/Q.931 SETUP message is sent to the remote H.323 
device. 


e The overlap dialing functions as follows: the called number is sent digit by digit from the terminal. The 
routing table contains parameters to determine the criteria to be used to consider the number as 
"routable". The criteria can be the length (i.e. the number of digits must reach a certain length, which 
can be null for full transparency of the overlap dialing) or a timeout (the device awaits digits for a 
certain time) and can depend on the beginning of the number (consequently, several number formats 
can be used). A "routable" number can be considered as "complete" or not: if not, overlap dialing will 
be possible end-to-end. The "routable" number is used for admission request if a gatekeeper is used. 


Example of ISDN overlap dialing and H.323 in-bloc dialing with a length of 3 digits for routing: 


ISDN Terminal ONE200/400 Gatekeeper Remote End 


SETUP 




















SETUP ACK 
INFO Digit 3 


INFO Digit 0 
INFO Digit 2 


CALL PROCEEDING 
ARQ n°302 


ACF 


SETUP n°302 SETUP n°302 
SETUP ACK 


CALL PROCEEDING 
ALERT ALERT ALERT 


CONNECT CONNECT CONNECT 





Note: The CALL PROCEEDING is sent by the OneOS-based voice-capable router to avoid a timeout on 
the terminal side due to an excessive time required by gatekeeper admission and SETUP message 
emission. The SETUP message is sent by the ONE200/400 to the gatekeeper, because routed signaling is 
used. It is possible the SETUP is sent to the remote device in non-routed mode. 


Example of end-to-end overlap dialing with a length of 3 digits for routing: 


Page 4.1-44 of 166 


ONEOS V4.2R5 VOICE USER GUIDE (EDITION 5) 
























































ISDN Terminal ONE200/400 Gatekeeper Remote End 
SETUP —_—_> 
4— _—S_ SETUP ACK 
INFO Digit3 ——>» 
INFO Digit? ——> 
INFO Digit2 ——> 
ARQ n°302 
INFO Digit 4 ——j> ACF 
INFO Digit6 ———B> = SETUP n°302 SETUP n°302 ——> 
4— SETUP ACK 
INFO Digit 1 ———> ae 
INFO Digit 461 INFO Digit 4641 ——> 
INFO Digit 7 ———> INFO Digit 7 INFO Digit7 ——» 
INFO Digit 9 —— > INFO Digit 9 INFO Digit 9 ——»> 
-— CALL PROCEEDING CALL 4-— CALL PROCEEDING 
PROCEEDING 
<+— ALERT ALERT <-— ALERT 
q— CONNECT CONNECT <-— CONNECT 








Note: The OneOS-based voice-capable router supports also overlap dialing for incoming calls (from H.323 
to ISDN terminal). The signaling is routed through the gatekeeper. 


4.1.2.4.2 Ringback tones and announcements 


The OneOS-based voice-capable router generates a configurable dialing tone (on the B channel) in case 
of overlap dialing until the reception of the first digit. 


When the SETUP message is sent to the H.323 remote end, the remote end can behave in three different 
ways: 


e The remote endpoint sends a 'CALL PROCEEDING’ or 'ALERT' message with the Information 
Element (IE) 'Progress' with "in-band" as information. Additionally, the RTP channel is established 
without waiting for full call establishment and the ISDN B channel is open. This method allows the 
remote H.323 device to send specific tones (such as customized ringback tones) or vocal 
announcements. 


e The remote endpoint sends a 'CALL PROCEEDING’ or 'ALERT' message with the Information 
Element (IE) 'Progress’ with "in-band" as information. But the RTP channel is not open, though. The 
ISDN B channel is open even though the RTP channel is not open. The ringback tone is generated 
locally. 


e The remote end does not send an Information Element with "Progress In-band": the OneOS-based 
voice-capable router sends a ringback tone in the B channel when receiving the 'ALERT' message 
from the remote end. The RTP channels will be opened after the connection (the remote endpoint off- 
hooks the phone). 


4.1.2.4.3 Disconnection 


The OneOS-based voice-capable router can also receive a "Progress In-band" IE in the 'RELEASE 
COMPLETE' message: it allows the remote H.323 device to indicate that there is a vocal announcement. 
The RTP channels are not disconnected and the OneOS-based voice-capable router waits for a 
disconnection from the ISDN terminal (a timer set at 30 seconds is used by the OneOS-based voice- 
capable router in case of non disconnection). 


The OneOS-based voice-capable router can optionally generate itself release tones in the B channel. It 
inserts then a "Progress In-band" information element. This feature is used if the PBX is not able to 
generate an appropriate tone to the user. 
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4.1.2.4.4 Advice of charge 


The OneOS-based voice-capable router is able to send charging information on ISDN port. The 
provisioning can be done for each voice-port (for AOC-D and AOC-E) if the terminal is not able to request 
the service by itself. The charging information comes from the remote H323 softswitch with two possible 
formats: ETSI or ECMA. The OneOS-based voice-capable router translates the information into the ETSI 
or EuroNumeris format towards the ISDN terminal. 


The AOC-E (end of call) charging can be computed by the OneOS-based voice-capable router itself if the 
softswitch does not support it. 


4.1.2.5 Analog Port Signaling 
4.1.2.5.1 Dialing 


When detecting an off-hook, the OneOS-based voice-capable router emits a configurable dialing tone until 
the reception of the first digit. If no digit is received within a configurable delay, a busy tone is sent and the 
OneOS-based voice-capable router waits for an on-hook. 


As an alternative, the OneOS-based voice-capable router can send a call with a pre-configured number 
when detecting an off-hook condition (direct call). 


The destination number is sent digit by digit by the terminal. The routing table contains parameters to 
determine the criteria making the number "routable". The criteria can be the length (i.e. the number of 
digits must reach a certain length which can be null for full transparency of the overlap dialing) or a timeout 
(the device awaits digits for a certain time) and can depend on the beginning of the number (consequently, 
several number formats can be used). A "routable" number can be considered as "complete" or not 
(configurable in the routing table): if not, overlap dialing will be possible end-to-end. The "routable” number 
is used for admission request if a gatekeeper is used. 


4.1.2.5.2 Tones & Announcements 
The OneOS-based voice-capable router behavior is similar to the one described for ISDN terminals. 
4.1.2.5.3 Ringing 


In case of incoming call, a Ringing signal is sent to the terminal. The ringing signal is fully configurable. A 
configurable timer limits the ringing duration without detection of an off-hook. 


4.1.2.5.4 Caller Identification 


The OneOS-based voice-capable router generates the appropriate information about the caller number 
during the ringing signal. Two modes are supported: FSK or DTMF. The initial ringing duration is 
configurable. 


4.1.2.5.5 |H.245 Terminal Capabilities 


The OneOS-based voice-capable router sends a configurable list of coders in the terminal capability 
message (or in the SETUP message in Fast Connect mode). For each coder, the timestamp must be 
indicated. 


4.1.2.5.6 Advice of charge 


The OneOS-based voice-capable router is able to send charging information on analog port by using 
several methods: 12/16 KHz pulse, polarity inversion or ETSI-compliant advice of charge. The provisioning 
can be done for each voice-port. 


4.1.2.5.7 Line Power Drop 


The FXS line power is forced off when the port is in “shutdown” state. It is possible to shut down the port if 
the VoIP gateway is not operational (available for SIP only). This feature is mainly used for alarm devices. 
See the intrusive-voiceport command in sip-gateway parameter group, for more details. Some 
timers are configurable for each port: see the £xs—power-timeout in voice-port parameter group for 
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4.1.2.6 


more details. 


FXO Port Signaling 


4.1.2.6.1. Outgoing Call 


4.1.2.6 


4.1.3 


4.1.3.1 


When voice routing is configured such that a call must be routed to a FXO port, the OneOS-based voice- 
capable router first makes an off-hook transition that indicates to the network that the subscriber is going to 
dial. Then, the first digits are sent after a configurable time. There is no detection of dial tone before 
sending the digits: there will not be any call failure due to a wrong tone configuration. 


The number is sent digit-by-digit. The digit duration and the time between two consecutive digits are 
configurable. 


After sending the last digit, the voice path is established and the call is considered as connected. There is 
neither ring back tone detection nor polarity reversal detection. 


.2._ Incoming Call 


The ringing signal of an incoming call is detected after the configurable number of ringing pulses. The 
Caller Identification is not supported; in other words, the calling number is unknown. 


Upon ringing signal detection, two behaviors are possible, depending on the configuration: 


1. First behavior called ‘second-step dialing’: in this mode, the FXO port goes directly to the off-hook 
state and works as a FXS port for the dialing reception (a dial-tone is transmitted). The received 
digits are processed through the routing table until a match is found. If a match is found, the call is 
routed to the appropriate subscriber. 


2. Second behavior called ‘direct routing’: the call is routed to a predefined port. The off-hook state is 
set when the call is connected. In case of remote disconnection, successive off-hook / on-hook 
signals notify the disconnection to the calling party (fixed duration: 1 second). 


If direct routing is not configured and no route is found in second step dialing mode, the incoming call is 
disconnected by successive off-hook / on-hook signals (fixed duration: 1 second). 


SIP Protocol Overview 
Signaling Processing 


The OneOS-based voice-capable router implements the SIP protocol in conformance with: 


e RFC 3261: Session Initiation protocol (SIP). Describes how to open and to close a session between 
two peers with or without a proxy / call Agent. 


e RFC 2327: Session Description Protocol (SDP). Describes how to negotiate and establish the media 
channels. 


e RFC 3204: MIME media types for ISUP and QSIG Objects. Describes how to transport SS7 / QSIG 
layer 3 messages to a call agent. 


e RFC 3459: Critical Content Multi-purpose Internet Mail Extensions (MIME) Parameter. Update of the 
RFC 3204, providing complementary information. 


e RFC 3372: SIP for Telephones (SIP-T): Context and Architectures. Specifies the use of SIP for an old 
telephony network. Gives example for an ISUP/SS7 to SIP translator. This RFC can be used for 
information about how to make interworking between ISDN and SIP. 


e RFC 3665: Session Initiation Protocol (SIP) Basic Call Flow Examples. Gives examples for a minimum 
SIP implementation. 


e RFC 3325: Private Extensions to the Session Initiation Protocol (SIP) for Asserted Identity within 
Trusted Networks. 


e RFC 3666: Session Initiation Protocol (SIP) Public Switched Telephone Network (PSTN) Call Flows. 
Gives examples of call flows for ISUP and ISDN interworking. 


e RFC 3515: The Session Initiation Protocol (SIP) Refer Method. 
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The following SIP messages are supported: INVITE (RE-INVITE), ACK, REGISTER, CANCEL, OPTIONS, 
UPDATE, PRACK, and NOTIFY. 


4.1.3.2 Dialog with SIP-Proxy 


The OneOS-based voice-capable router supports the registration to a SIP registrar and can function with 
several SIP proxies. You can define an alternate registrar for backup. Keepalive values to check access to 
the SIP proxy and registrar. 


4.1.3.3 Dialog via Outbound Proxy 


The OneOS-based voice-capable router can optionally send all the Registration and/or call signaling 
messages to an outbound proxy. Generally, this feature is required when a Session Border Controller is 
used. The packet payload containing SIP signaling is addressed to the proxy but the IP packet destination 
address is the IP address of the outbound proxy. 


4.1.3.4 Voice Path Establishment 


The RTP flows are established in two-way mode when the 200 OK message is sent and ACK received. 


Sometimes, tones and announcements may be sent before the call connection. It may be necessary to get 
all the SDP information before the 200OK/ACK exchange. 


The use of SDP in 1xx message is allowed by a specific configuration parameter and has the following 
effects: 


e SIP->ISDN call: a SDP part will be added if a Progress In-band IE is received on the ISDN port. 


e For ISDN->SIP call: the SDP part of a 1xx message will be processed and translated to an IE 
progress in-band towards the ISDN port. 


e For SIP outgoing calls: whatever the SDP in 1xx message is used or not, the OneOS-based voice- 
capable router is able to receive any RTP flow just after sending the INVITE message (it includes a 
SDP part). The RTP flow will be sent by the OneOS-based voice-capable router as soon as a SDP 
part is received. 


e For SIP incoming calls: the OneOS-based voice-capable router can send the SDP information in 
180/183 message (if configured and presence of IE progress In-band) or will send it in the 200OK. It is 
ready to receive RTP flow at this stage. It will send RTP flow as soon as it has sent and receive SDP 
information. 


PRACK message is also supported: it may be required by to SIP proxy to send RTP flow before the 
connection. 


4.1.3.5 From & To and Contact fields configuration 


For the "From" & "To" and "Contact" fields, the following parameters are configurable: 


1. sip-username: SIP identifier 
2. hostname: domain name or IP address 
3. authentication: username & password 


A local subscriber is identified by sip-username@hostname. The sip-username is generally the phone 
number but it can be replaced by a name (routing table configuration). The hostname can be written as an 
IP address or a configurable name (global choice in the SIP gateway configuration or configured in the 
routing table). 


The routing table is scanned during registration: dial-peer pots including the “ua-sip” option are registered 
with the prefix or a configurable sip-username and hostname. Specific usernames and passwords can be 
defined for authentication. The SIP gateway can also register with a global configurable sip-username and 
hostname. 


The calling number is searched in the routing table when a call is received on a local port. If found (match 
with dial-peer pots and prefix), an optional sip-username and hostname may replace the number and a 
specific username & password can be used for authentication. For a call coming from a SIP proxy, the 
username in the "To" field can also be translated to a phone number. 


The “To” field is built with the destination phone number and a domain name or IP address. The phone 
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number can optionally be replaced by a name (sip-username) if configured in the routing table. The 
domain name or IP address is the SIP proxy address. 


4.1.3.6 | Mapping of Release Causes 


If the SIP response releasing the call contains a reason header (see RFC 3326), the Q.850 release cause 
of that header is used as ISDN release cause. 


When an ISDN => SIP call is released by the SIP network before the call is established, the SIP response 
code (4xx, 5xx, 6xx) is mapped into an ISDN release cause as specified by the table below: 




















ISDN Cause 
SIP Response Code 
N° Definition 

400 Bad Request 127 Not specified 
401 Unauthorized 127 Not specified 
402 Payment Required 127 Not specified 
403 Forbidden 127 Not specified 
404 Not Found 1 Unallocated (unassigned) number 
405 Method Not Allowed 127 Not specified 
406 Not Acceptable 127 Not specified 
407 Proxy Authentication Required 127 Not specified 
408 Request Timeout 127 Not specified 
410 Gone 22 Number changed 
413 Request Entity Too Large 127 Not specified 
414 Request-URI Too Long 127 Not specified 
415 Unsupported Media Type 127 Not specified 
416 Unsupported URI Scheme 127 Not specified 
420 Bad Extension 127 Not specified 
421 Extension Required 127 Not specified 
423 Interval Too Brief 127 Not specified 
480 Temporarily Unavailable 20 Subscriber absent 
481 Call/Transaction Does Not Exist 127 Not specified 
482 Loop Detected 127 Not specified 
483 Too Many Hops 127 Not specified 
04 Adress Incomplete Su eee i eee rr aa 
485 Ambiguous 127 Not specified 
486 Busy Here 17 User busy 
487 Request Terminated 16 Normal Call clearing 
488 Not Acceptable Here 127 Not specified 
491 Request Pending 127 Not specified 
493 Undecipherable 127 Not specified 
500 Server Internal Error 127 Not specified 
501 Not Implemented 127 Not specified 
502 Bad Gateway 27 Destination out of order 
503 Service Unavailable 127 Not specified 
504 Server Time-out 127 Not specified 
505 Version Not Supported 127 Not specified 
513 Message Too Large 127 Not specified 
600 Busy Everywhere 17 User busy 
603 Decline 21 Call rejected 
604 Does Not Exist Anywhere 1 Unallocated (unassigned) number 
606 Not Acceptable 127 Not specified 
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When a SIP => ISDN call is released before call establishment, the ISDN release cause is mapped into the 
following SIP responses: 




















Outgoing calls 
ISDN cause SIP Response 
N° Definition Code 

1 Unallocated (unassigned) number 404 

2] No route to specified transit network 500 

3 No route to destination 500 

6| Channel unacceptable 500 

7| Call awarded and being delivered in an established channel 500 

8| Preemption 500 
16] Normal Call clearing 487 
17] User busy 486 
18) Nouser responding 480 
19] No answer from user (user alerted) 480 
20| Subscriber absent 480 
21} Call rejected 480 
22} Number changed 410 
26 | Non-selected user clearing 480 
27 | Destination out of order 502 
28 | Invalid number format (address incomplete) 484 
29| Facility rejected 500 
30 | Response to STATUS ENQUIRY 500 
31 Normal, unspecified 480 
34 |} No circuit/channel available 480 
38 | Network out of order 500 
39 | Permanent frame mode connection out of service 500 
40 | Permanent frame mode connection operational 500 
41 | Temporary failure 500 
42) Switching equipment congestion 500 
43 Access information discarded 500 
44 | Requested circuit/channel not available 500 
46 | Precedence call blocked 500 
47 Resource unavailable, unspecified 500 
49} Quality of service not available 500 
50 | Requested facility not subscribed 500 
57 | Bearer capability not authorized 500 
58 | Bearer capability not presently available 500 
62 | Inconsistency in designated outgoing access information and subscriber class 500 
63} Service or option not available, unspecified 500 
65 | Bearer capability not implemented 500 
66 | Channel type not implemented 500 
69 | Requested facility not implemented 500 
70} Only restricted digital information bearer capability is available 500 
79 Service or option not implemented, unspecified 500 
81 | Invalid call reference value 500 
82 | Identified channel does not exist 500 
83 | A suspended call exists, but this call identity does not 500 
84) Call identity in use 500 
85] No-call suspended 500 
86 | Call having the requested call identity has been cleared 500 
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87 
88 
91 
95 
96 
97 


98 


99 
100 
101 
102 
110 
111 
127 





User not member of CUG 

Incompatible destination 

Invalid transit network selection 

Invalid message, unspecified 

Mandatory information element is missing 
Message type non-existent or not implemented 


Message not compatible with call state or message type non-existent or not implemented 


Information element /parameter non-existent or not implemented 
Invalid information element contents 

Message not compatible with call state 

Recovery on timer expiry 

Message with unrecognized Parameter, discarded 

protocol error, unspecified 

interworking unspecified 





500 
500 
404 
500 
500 
500 


500 


500 
500 
500 
480 
500 
500 
480 





4.1.3.7 


Complementary services 


In case of SIP application case, advanced complementary services are provided on FXS devices or ISDN 


devices: 


FXS ports (see 4.2.8.2.2 for more details): 


Call waiting 
CLIP / CLIR 
Hold / Retrieve 


Brokering 


Attended call transfer 


Explicit call transfer 


3-party conferencing 


Message Waiting Indication 


ISDN devices (Euro-ISDN only): 

Call forwarding (CFU, CFNR, CFB) 
CLIP/CLIR 

Hold / Retrieve 


Suspend / Resume 


Attended call transfer 


Explicit call transfer 


Call deflection 


Call rerouting 


Message Waiting Indication 


3-party conferencing 


Note: no standard SIP - AOC interworking exists at the moment. 
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4.1.4 Call Routing 


The call is routed using one of two possible methods: 


e Implicit routing: all the calls are routed to a local port or to a remote H.323/SIP device, without any 
analysis of the called number. 


e Routing table: the destination number is compared with a list of configured number prefixes. The 
destination port (local port or remote VoIP peer) is found if the called number matches with one of the 
prefixes. If a gatekeeper is not used, the routing table may directly include the IP address of the called 
VOIP device (SIP or H.323 gateway/terminal). 


The routing table defines also the numbering plan for overlap dialing (number length depending on the 
prefix) and identifiers for registration to the gatekeeper (for local ports only). 


Several cases are to be considered: 


e Case of ISDN calls in bloc mode routed to a VoIP device using a softswitch. In this case, the implicit 
routing is sufficient. 


e Case of ISDN calls in overlap dialing mode or analog calls with the necessity to record several digits 
before sending an admission request to a softswitch. In this case, the routing table must be used to 
precise the number length. 


e Case of calls without a softswitch. Except in case of trunking, the routing table is required to determine 
the destination VoIP device by an IP address. 


The order of the configured routing rules is important: the rule number one is tested first, and then the rule 
number two, etc. For a call coming from a local port, the rules indicating a VOIP device are checked before 
the rules indicating a local port. For a call coming from a VOIP device, the rules indicating a VOIP device 
are not checked. 


Once a routing rule matches the called number, the outbound port is determined and also the IP address if 
the port indicates a VOIP device. The called number can be transformed by suppressing and/or adding 
digits. 


4.1.4.1. Incoming Call Routing 


For each incoming call, the routing is broken down into two phases: first to apply some special actions for 
the incoming call, then the outgoing port is selected. The first routing can be used: 


e To make specific number translations on the calling & called number 


e (For calls coming from H.323/SIP only) To determine the dial-peer VoIP to be used (and therefore the 
voice coding profile) 


e Optionally, to define a specific number intended for the reboot of the device (locally or remotely) for 
maintenance purpose. 


4.1.4.2 Local Port Routing 


The routing table specifies a group identifier if the destination is a local port. Each local port belongs to a 
group: this feature enables the definition of several interfaces with the same number (very common 
situation with a PBX connected with several BRI ports). For each port, a priority inside the group can be 
defined. When ports have the same priority, a circular selection is made (round robin) or the port with least 
load in selected (load balancing). 


Example for round robin: Port 1: priority 1, Port 2: priority 2, Port 3: priority 2, and Port 4: priority 2. The call 
is routed to port 1 if available. If it is not available, the call is routed to port 2 then ports 3, 4, 2,3 ... and so 
on. 


4.1.4.3 Call Hunting 


It is possible to enable a call hunting for a POTS group (see the routing table configuration). If enabled, a 
call routed to this group, is sent to each interface of the group until a successful call (including normal 
failure causes, for example, wrong number or user busy). The up interfaces are tried first, and then the 
down interfaces if no up interface is available. The call is released if all the interfaces of the group have 
been unsuccessfully tried. 


A BRI interface is declared down if a call is unsuccessful (with a Q.850 release cause greater than 31). It is 


Page 4.1-52 of 166 


ONEOS V4.2R5 VOICE USER GUIDE (EDITION 5) 


declared up at startup and after a successful call. Call hunting may be used for backup: if a BRI interface is 
down, the call is sent again (after two seconds) to another interface inside the same group. 


The call hunting is disabled in case of overlap dialing. 
4.1.4.4 Backup Call Routing 


A backup call routing is possible in case of outgoing call failure. The criterion is simple: the ITU-T Q.850 
cause value must be different from a class 0 or 1, which are expected type values in normal cases. A 
typical application is backup call routing of the VoIP network by a legacy ISDN network: the main route is 
VoIP and in case of IP network failure (uplink disconnected, unreachable softswitch...), the call is routed to 
the ISDN network connected to a SO / S2 interface. 


This feature is configured in the routing table. 
4.1.4.5 | Number Translation 

It is possible to configure translations on the calling and/or called number. 
4.1.4.5.1. | Calling Number Translation on Local Ports 


Parameters attached to each local port enable suppression of the calling number or insertion of a prefix in 
the calling number of the call coming from the local device. The same actions will be applied on the 
"Connected number" of a CONNECT message coming from the local device. 


Insertions in calling numbers are used for example to add a prefix identifying a PBX to a local phone 
number: a local user identified by "3007" will be identified as "0141873007" in the VoIP network in case of 
outbound call, by inserting the prefix "014187". 


4.1.4.5.2 Calling & Called Number Translation by Using the Routing Table 


The routing table offers the possibility to make translations on the calling and/or called number: prefix 
suppression & insertion, suffix suppression & insertion. It is also possible to configure specific translations 
of any patterns in the calling and/or called number. 


The main benefit is to define translation for specific numbers (calling and called) only. 


The translation can be defined for the incoming routing and outgoing routing. 
4.1.4.6 CLIR Complementary Service 


The ISDN CLIR (Calling Line Identification Restriction) is a feature that allows the calling number to be 
presented to the called party and screened by the network. With H.323, the CLIR is relayed transparently 
between ISDN and H.323. With SIP, some privacy extensions have been brought to the SIP header (for 
the field P-Asserted-Identity). A standard mapping between the ISDN CLIR and SIP privacy extensions 
was defined by ETSI standards. 


Additionally, the routing table makes it possible to overwrite the Calling Line Identification Restriction. For 
example, it is possible to enable the CLIR for calls coming from a specific local port or specific calling 
number. 


The presentation code and the screening indicator provided in the "3A byte" of the Q.931 calling number 
information element could be set. 


Presentation code: 

e 0: Presentation allowed 

e 1: Presentation restricted 

e  2:Number not available due to interworking 
e 3: Reserved 

Screening Indicator: 

e 0: User provided, not screened 


e 1: User provided, verified and passed 
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e 2: User provided, verified and failed 
e 3: Network provided 


Note: whatever the configuration and/or the "3A byte" value received, the calling number is not suppressed 
or modified by the OneOS-based voice-capable router (except with the number translation facility). 


4.1.4.7 | Bearer Capability processing 


The routing table offers the possibility to force the Bearer Capability Information Element for calls sent to 
the H.323 network or to the ISDN terminals. 


The typical application is to force, for example, a "3.1Khz audio" bearer capability for a terminal which is 
not able to indicate this value (for example, for a voice-band modem). 


If the Bearer Capability is forced to "Unrestricted", the call is then considered as a data call (the CES clear 
channel coding mode will be used). 


4.1.4.8 Tones and Announcements 


The OneOS-based voice-capable router generates a configurable dialing tone (on the B channel) in case 
of overlap dialing until the reception of the first digit. 


The Information Element (IE) ‘progress in-band’ can be passed on the ISDN ‘ALERT’ and ‘CALL 
PROCEEDING’ messages. When such IE is passed, the ISDN B-Channel must be established so that the 
user can hear the ringback tone during call establishment 


The IE ‘progress in-band’ is not passed transparently through the SIP signaling contrarily with H.323. 


If the OneOS SIP gateway receives an 18x SIP response containing SDP (such ‘180 RINGING’ or ‘183 
Session In progress’), the SIP gateway builds the B-channel and starts listening to the RTP flow. In other 
words, when receiving SDP in 18x message, the SIP-gateway can connect the calling user to customized 
ringback tones. 


If the OneOS SIP gateway receives the IE ‘progress in-band’ on the ISDN side, the B-channel is open, the 
SIP-gateway sends a SIP 183 response message and starts sending RTP. In that case, the ISDN terminal 
is providing a ringback tone or a special voice announcement. 


4.1.4.9 | Numbering Plan processing 


It is possible to check a specific numbering plan type with a number or prefix defined in the routing table. 


It is also possible to force a numbering plan value for the called or calling number (see the routing table 
configuration). 


To make the routing table as simple as possible OneOS can manage the numbering plan. In that case it is 
possible, for FXS and SIP, to specify the default type of number (national or unknown), the processing 
applied to the number before the routing table (optional pre-processing) and the processing applied to the 
number after the routing table (optional post-processing). 


4.1.4.10 Call-Triggered Reboot 


It is possible, for a maintenance purpose, to define a specific number to control a reboot. When a call is 
received with a configured specific number, the OneOS-based voice-capable router disconnects all the 
current calls and reboots. A specific configuration file that must be used after reboot can be indicated in the 
configuration (see the routing table configuration): the current startup configuration file is overwritten by the 
selected file. 


This functionality is can be used to reboot locally or remotely the device without entering in the 
configuration. 


4.1.4.11 Date & Time 


The OneOS-based voice-capable router can optionally send the date & time to the local ports (analog or 
ISDN) if it is synchronized on a SNTP/NTP server. This feature can be activated on a per-port basis (voice- 
port parameters). 
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4.1.4.12 Number Portability 


During the transient phase when number portability between telephone operators is realized, the OneOS- 
based voice-capable router is also connected to the former ISDN network during a period to be sure that 
any call coming from the previous ISDN network is routed to the PBX and not lost. When the number 
portability is done, any call should be coming from the VoIP network so that the connection to the former 
ISDN network becomes useless. 


A function, embedded in the OneOS-based voice-capable router, provides logs and alarms enabling a pro- 
active number portability management. 


When the number portability is enabled, the OneOS-based voice-capable router starts in the “portability in- 
progress” state as soon a call is received from the VoIP network. A configurable timer is started. If a call is 
received on the ISDN network interfaces, the timer is restarted. If the timer is expired, the OneOS-based 
voice-capable router is in state “portability done”. If the number portability is set to done and if a call is 
received on the interfaces connected to ISDN, then an alarm is generated. 


An "alarm / event" is generated each time the state of number portability changes. 
4.1.5 Voice Processing 


With subscribers using ISDN, the voice signal coded in PCM 64Kbps (G.711 A-law or u-law) from the 
subscriber side is either transmitted transparently or coded with a lower bit rate (e.g. in ADPCM -G.726- 
32Kbps or G729AB at 8Kbps) by the access device. The transit delay induced by the IP network can be 
higher than a few tens of milliseconds; consequently, the access device must cancel the electric echo 
generated by the 2-wire / 4-wire device inside the connected analog telephone terminals. In order to 
reduce the bandwidth requirement for voice communication, silence can be suppressed. 


These coders are supported: 

e G.711 A law (64Kbps) 

e G.711 u-law (64Kbps) 

e G.729A (8 Kbps, no silence suppression) 

e G.729AB (8 kbps, optional silence suppression) 

e CES Clear Channel (64Kbps) for unrestricted data on ISDN interfaces (transparent codec) 
The RTP/RTCP protocol is used for voice packet transmission. 


The transmission periodicity is configurable at 10, 20, 30, 40 ms for G.729A/AB, G.711, and CES. The 
ONE200/400 accepts any periodicity on the reception flow and supports the asymmetric coding mode (for 
example: transmission in G.729, reception in G.711). 


The silence suppression is compliant with the standard referenced in G.729AB and G.723.1. For the other 
coders (G.711, G.726), silence is suppressed using an optional comfort noise generation (the noise level is 
sent periodically to the remote end) in conformance with RFC3389. 


The CES enables the transmission of any data application over an ISDN B Channel. This coder is 
automatically selected if the Bearer Capability requested in the SETUP message indicates "unrestricted 
data" and if the local port is ISDN type. For a reliable data communication without any error, the 
synchronization must be achieved externally and is identical for both sides of the communication: 


e Synchronization provided by the ISDN port (if PRI or BRI in TE mode) 
e Synchronization provided by the uplink if DSL is used. 


4.1.5.1 Hosted Nat Traversal 


In some applications, it is necessary to maintain a continuous RTP flow in order to keep the NAT sessions 
open in external routers. A parameter enables this feature: silence RTP packets are sent when the call is 
on hold as soon as the remote IP address & port are known. It is available for SIP only. See rtp- 
permanent parameter in dial-peer voice voip parameter group for more details. 


4.1.5.2 Bandwidth Limitation 


To avoid congestion on the uplink (and consequently a bad quality on each voice call), it can be necessary 
to have a bandwicth limitation. 
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It is possible to limit the total RTP bandwidth with a global parameter (sip/h323-gateway, max-bandwidth 
command). Upon each call, the current bandwidth is checked before accepting it. The voice coder list can 
be reduced to the low bit rate coders for this call if, for example, there is not enough bandwidth for G711. 


When several coders are available, OneOS allows using a better quality voice coder when the bandwidth 
is available (the preferred coder is G711). If the bandwidth is available, the G711 is selected for voice 
coding & decoding. In case of new call and if the actual used bandwidth is above a configured threshold of 
the available bandwidth (see dynamic-coder-selection command), then the coder of (one or more) 
current calls are switched from G711 to G729 (when a call is switched from G711 to G729, there is no 
switch back to G711). This feature is available in H323 (capabilities renegotiation) and SIP (re-INVITE). 
Calls are switched to G729 according to the following rules: 


e Pass through fax/modem calls, T38 fax calls and UDI64K calls are never switched to G729. 


e Voice calls already switched to G729 and switched back to G711 by the remote end are switched to 
G729 the last ones. 


e Other voice calls are switched to G729 the older first. 

The number of concurrent calls can also be limited for each configured dial-peer VoIP. 

In case of H.323, the bandwidth can also be controlled by the gatekeeper with the RAS signaling protocol 
(optional). 


4.1.5.3 Emergency calls 


The emergency call service gives highest priority to call destined to high priority dial numbers (such 
firefighter department). An emergency level is defined by a number between 1 and 200. A lower value has 
a higher emergency level or priority. 


The process is the following: 
1. An emergency level can be assigned to calls from defined local ports. 


2. An emergency level can be assigned to a call by the routing process, depending on the called 
and/or the calling number. 


3. The minimum value from 1 and 2 will be considered (for example, if physical port has an 
emergency level of 3 and the called number has an emergency level of 2, then the emergency level 
of the call will be 2). 


4. When a call is routed to an interface and if there is not enough resources to send the call (no 
available B channel, bandwidth, etc...), the emergency level of the call is compared to the level of 
the current calls. If it is higher than a current level, the active call is disconnected and the resource 
is affected to the new call. 


Note: in this release, the emergency process is available on FXO port only. 
4.1.5.4 Group 3 FAX Processing 


Transparent Mode 


The G3 FAX can be transported by using G.711 coding. The OneOS-based voice-capable router 
automatically disables the Echo Canceller if a G3 FAX is detected (optional) or switches the echo-canceller 
to a specific mode. The G.711 coder can be selected per configuration or dynamically during a voice 
communication when a modem or FAX is detected: this mode is called "Modem pass-through". 


FAX Pass-through 


The OneOS-based voice-capable router can switch to a G711 coding mode dynamically during a voice 
communication when a Group 3 FAX is detected. The Echo Cancellation remains enabled but in a specific 
mode (for G3 FAX). Several methods are proposed to force the communication to G711: 


e Direct mode: proprietary method consisting in switching the RTP flow to G711 without any H.245 or 
SIP exchange. 


e (H.323-specific) Request mode: standardized method using the h245 “request-mode” message to 
force the closing of the current channels and the reopening of G711 channels. 


e (H.323-specific) TCS Null method: the h245 capabilities are renegotiated and forced to G711. 
e  (SIP-specific) RE-INVITE method is used to renegotiate a coder compatible with fax-pass-through. 
FAX Relay 
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The OneOS-based voice-capable router also supports FAX Relay compliant to ITU-T T.38 (UDP mode). 
The signal is modulated & demodulated locally, the T.30 messages are analyzed and relayed, and the fax 
data is transported transparently over IP/UDP. The V.27ter (4800 bps) and V.29 (9600 bps) modulations 
are supported. The OneOS-based voice-capable router offers FAX Spoofing to avoid FAX failures in case 
of long transit delay over IP. An optional mechanism forces a fallback of V34 FAX communication (Super 
G3) to Group 3 communication, so Super G3 faxes can communicate with T.38 instead of G.711 pass- 
through. 


4.1.5.5 | Modem Processing 


Transparent Mode 


A Modem signal can be transported by using G.711 coding mode. The OneOS-based voice-capable router 
can automatically disable the Echo Canceller if a modem is detected. The G.711 coder can be selected by 
configuration: permanently or on call-by-call basis by the calling/called number analysis. 


Modem Pass-through 


The OneOS-based voice-capable router can switch to a G.711 coding mode dynamically during a voice 
communication when a modem or Super Group 3 FAX is detected. The echo-cancellation is automatically 
disabled. Several methods are proposed to force the communication to G711: 


e Direct mode: proprietary method consisting in switching the RTP flow to G711 without any H.245 or 
SIP message exchange. 


e Request mode: standardized method using the h245 “request-mode” message to force the closing of 
the current channels and the reopen of G711 channels. 


e (H.323-specific) TCS Null method: the h245 capabilities are renegotiated and forced to G711. 
e (SIP-specific) RE-INVITE method is used to renegotiate a coder. 


4.1.5.6 |DTMF Processing 


DTMF is processed by using the H.245 message or via SIP INFO in alphanumeric format. The DTMF 
codes are detected in the received voice signal, suppressed before sending the RTP flow and regenerated 
at the remote end. The DTMF level and duration are configurable; however, the DTMF codes can be 
transmitted transparently when the G.711 coder is used. 


Alternatively, DTMF can be processed in-band as specified by RFC 2833. 
Note: SIP INFO method is not supported for DTMF coming from a remote SIP device. 


4.1.5.7 MOS scoring 


As of OneOS V4.2R4 release, the Mean Opinion Score Conversational Quality (MOS-CQ) and the Mean 
Opinion Score Listening Quality (MOS-LQ) are included in the call details and statistics. 


The MOS is a measurement (value between 1 and 5) of voice quality based on subjective criteria while 
surveying many people; the higher the MOS, the higher the probability a human being would consider 
voice quality to be excellent. Some models were created to compute a MOS evaluation from measurable 
data. One of them is the E-model of ITU-T Recommendation G.107. The E-model computes first an R 
factor; then a formula derives a MOS from R. The computation of R factor is complex and requires some 
metrics that cannot be easily obtained by OneOS. Some metrics have been then chosen to a default value. 


The following table gives the definitions of the categories of speech transmission quality in terms of ranges 
of Transmission Rating Factor R provided by ITU-T Recommendation G.107. This table also gives the 
descriptions of "User satisfaction" and equivalent transformed values of R into conversional MOS-CQ for 
each category. 























iceerinn MOS-CQ Speech transmission quality User satisfaction 

90 4.34 Best Very satisfied 

80 4.03 High Satisfied 

70 3.60 Medium Some users dissatisfied 

60 3.10 Low Many users dissatisfied 

50 2.58 Poor Nearly all users dissatisfied 
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The MOS calculation is implementation dependant. The MOS reported by an OneOS-based voice- 
capable router must only be compared with another OneOS-based router, not with 3-rd party 
vendor. Under ideal conditions, OneOS returns a MOS-CQ of 4.00 for G.729A and 4.35 for G.711A. 


The R factor for MOS-LQ calculation provided by OneOS takes into account the following parameters: 


e End-to-end frame loss (not only RTP packets lost by the network, but also frames lost internally by 
OneOS DSP because the de-jitter buffer is full for example). 


e Packet loss burstiness: packet loss concealment in DSP makes up for very sporadic packet loss so 
that a human ear hardly perceives the difference. But, if packet loss is bursty (i.e. 5 packets lost in a 
row), the impact on voice quality is worse. 


e Network jitter. 

e Codec type and packetization delay. 

The R factor for MOS-CQ calculation takes into account the following additional parameters: 
e Echo path loss and echo loudness rating. 


e One-way delay: approximated via the formula Ta = DSP_FIFO_Size + Round_Trip_Delay / 2 


The R factor calculation exploits information included in the RTCP and RTCP-XR frames received from the 
remote end. RTCP-XR frames are not enabled by default. Think to validate the RTCP-XR frames using the 
rtcp-xr command for a more accurate MOS calculation. 


The MOS-CQ and MOS-LQ as well as the remote MOS-CQ and MOS-LQ are displayed on a call by call 
basis using the show voice rtpcall short command. The remote MOS-CQ and MOS-LQ are only 
available if the duration call is long enough for the RTP protocol to set-up and rtcp-xr is in force. 


The graphical representation over time of the R factor related to MOS-CQ can be displayed on a call by 
call basis using the show voice rtpcall full command. The value of R is given every minute for the 
last 30 minutes of the call. 


A mean value of MOS-CQ for all calls is calculated on the flow and can be displayed using the show 
voice mos command. Use the show voice mos reset command to restart the mean calculation. 
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4.2 CONFIGURATION 


4.2.1 Introduction 


A set of command lines (CLI), dedicated to voice services enables the configuration of all necessary 
parameters. In general, the VoIP function requires the configuration of very few parameters. The OneOS- 
based voice-capable router permits the configuration of a comprehensive parameter set in order to adapt 
to all cases described in the standards. Most parameters will be set with default values, thereby reducing 
the number of steps required to configure the device. 


The configuration includes the following main commands: 


e voice-port: physical S0/S2/FXS port. Voice processing parameters are defined such as echo 
cancellation, gain and coding law. 


e interface: defines, for BRI and PRI only, parameters for the physical level and ISDN protocol. 
e dial-peer voice: logical internal ports. 


e dial-peer pots: local voice port always associated with a physical port. It enables the 
configuration of groups, direct call and number transformation. 


e dial-peer voip: remote H.323/SIP device. The IP address, H.323/SIP protocol parameters and 
coder profile are defined here. If a gatekeeper is used and all the remote devices have the same 
H.323/SIP parameters, a single dial-peer voip can be configured. 





e voip-coder-profile: to define a list of coders to be negotiated during capabilities exchange. 


e SIP/H323-gateway: defines all the parameters related to the SIP/H.323 gateway (use of 
gatekeeper, protocol parameters). 


e voice-routing: defines the rules to route the calls between the dial-peers (pots and voip). 


The relationships between configuration items are described in the following diagram: 


voice-port 












h323-gateway 
sip-gateway 










voice-routing 











#phy. port #dial-peer voip 



















physical port dial-peer dial-peer 
#phy. port voice pots voice voip 


#profile 


interface pri 
interface bri 


The following sequence for configuration is preferred: 


voip-coder-profile 


1. The physical voice ports using the voice-port command. 
2. The PRI or BRI interfaces using the interface pri and/or interface bri commands. 
3. The local voice ports using the dial-peer voice pots command. 


4. The voice gateway using the h323-gateway or sip-gateway command (Note that SIP and H.323 
are not supported simultaneously). 


5. The voice coder profiles using the voip-coder-profile command. 
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6. The remote voice devices using the dial-peer voice voip command. 


7. The voice calls routing using the voice-routing command. 
4.2.2 Configuration Management 


All the parameters may be changed online, except a few parameters specified in SIP/H.323-gateway. For 
these parameters, a shutdown command of the SIP/H.323 gateway is required (this requirement is 
indicated by a Warning message). 


4.2.3 Physical Voice Ports 


The OneOS-based voice-capable router voice module is always designated by the number 5. On a BRI 
module, the physical port is identified with a port number in the [0..(n-1)] range, where n is the total port 
number of the interface module (currently up to 8). 


Command for creation of physical port #0 (voice module number 5 on the ONE router): 


CLI (configure) > voice-port 5/0 
CLI (voice-port) > 





4.2.3.1 Parameters for Echo Cancellation 


To enable the echo canceller - default: enabled -, use the following command. The command no echo- 
cancellation disables the echo cancellation. 


CLI (voice-port)> [no] echo-cancellation 
To define the maximum tail length, use the following command. The low value is 8ms, medium is 16ms - 
default -, high is 32 ms; it must be configured medium or high if off-net calls must be supported. 

CLI (voice-port) > echo-cancellation-length {low | medium | high} 
To specify the conditions for disabling automatically the echo canceller, use the following command. If 
configured modem, the echo canceller is disabled upon detection of a modem tone. If configured 
voicemodem, the echo canceller is automatically disabled upon detection of a Group 3 FAX tone. If the 


modem-passthrough function is enabled, the echo canceller is also disabled upon modem detection 
whatever the configuration of this parameter. Default: not configured. 


CLI (voice-port)> echo-disable {voicemodem | modem} 
4.2.3.2 Parameters for Gain control 
To define the output gain (dB) and amplifies the signal for the voice flow sent to the remote VoIP peer - 
default: 0 (no gain) -, use the following command: 
CLI (voice-port)> output-gain <gain> 
To define the input gain (dB) and amplifies the signal for the voice flow received from the remote VoIP peer 


- default: 0 (no gain) -, use the following command: 


CLI (voice-port)> input-gain <gain> 
4.2.3.3. Parameters for Synchronization 


To select the synchronization input - default: aal2 -, use the following command: 


CLI (voice-port)> clock-source {aal2 |aall | free-run | dsl | pri | bri} 


As a unique clock source must be used, the modification is automatically applied to all voice-ports (except 
for pri, see bellow). If dsl or pri/bri is selected, a second parameter indicates the port number. 


If a BRI port is used, it must be configured as TE for the physical layer. AAL2 and AAL1 are only used for 
VoDSL (VMOA/VTOA) and CES. Special note for VoIP application: if the default value (AAL2) is selected, 
the free-run mode will be enabled. 


If bri is configured: any BRI interface (in TE mode only) is automatically selected for the clock 
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synchronization if the layer 1 is activated. If there is no BRI interface in TE mode and with layer 1 
activated, the internal clock is used (as free-run). 


pri must be configured on the PRI interface used for synchronization. In case of a two-PRI device, one 
PRI can be selected to be “slave” and the other one “master” in terms of clocking. 


4.2.3.4 Parameter for the ISDN Power Source One 


To enable (disable) the power source one (PS1) on the BRI interfaces - default enabled -, use the following 
command. It is global for all the ports: any modification is automatically applied to all the voice ports. 


CLI (voice-port)> [no] power-source-one 
4.2.3.5 Parameter for FXS Line Power Drop 


The following command configures the timer used for the FXS power drop feature: 
CLI (voice-port)> £xs-power-timeout init <hh:mm:ss> down <hh:mm:ss> 
up <hh:mm:ss> 
init: the power is up at the device starting and this timer is started. If the VoIP gateway is not operational 
when this timer expires, the power is dropped. Default: 180sec. 
down: if the VoIP gateway is not operational during this time, the power is dropped. Default: 60sec. 
up: If the VoIP gateway becomes operational during this time, the power is switched on. Default: 60sec. 


The up and down timers are defined to avoid power on/off in case of unstable VoIP gateway state. The 
init timer replaces the down timer for the device starting phase (after a reboot, it may take a long time to 
have the VoIP gateway up). 


4.2.3.6 Parameters for ringing (analog ports only) 

For analog ports only, the following command specifies the ring signal parameters. The frequency used 
complies with the selected country specifications. Default: France. 

CLI (voice-port)> ring {France | Germany | USA | Italy | Spain | UK 

| userdefined} 

The following command defines the ringing parameters for the userdefined ringing profile. freq is the 
frequency from 0 to 60 Hz, ton/toff are the emission/pause durations in ms (0-5000). 

CLI (voice-port)> [no] user-ring <freq> <ton-1> <toff-1> <ton-2> <toff-2> 
The following command specifies the standard to use to send the caller ID. Default: none. If FSK is 
selected, the caller ID as well as the time/date of the OneOS-based router is passed to the FXS phone. 


CLI (voice-port)> caller-id {none | dtmf | fsk} 


The following command specifies the initial ring tone (ms) for caller-id. 


CLI (voice-port)> initial-ring <10-2000> 


The following command defines the ringing voltage, for analog ports only (default: normal). 








CLI (voice-port)> ring-level { normal | high | max } 


The following table gives the available ring levels. 














ring level FXS300 board other FXS boards 

normal 37.47 Vrms centered on 41.38V 37.47 Vrms centered on 22V 
high 52 Vrms centered on 22V 40 Vrms centered on 18V 
max 65 Vrms centered on OV 45 Vrms centered on 11V 
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4.2.3.7 | Parameters for Tones 


The following command specifies the tones signal parameters. The frequencies and durations used 
comply with the selected country specifications. 


CLI (voice-port)> tone {France | Germany | USA | Italy | Spain | UK 
| userdefined} 


The following command specifies the transmit level for tones (dBm). Default: -10 dBm. 


CLI (voice-port)> tone-level <-40 to 0> 


The following commands define the parameters for each user-defined specific tone. 





CLI (voice-port)> user-tone {dial | network-failure | congestion | busy | 
callback} 


The following command must be entered to use a timing parameter (continuous tone if disabled). 


CLI (voice-port)> timing enable 


The following command cancels the timing parameters (the tone is continuous). 





CLI (voice-port)> timing disable 


The following command defines the durations for three successive signals (in millisecond). 








CLI (voice-port)> timing customs <on-1> <off-1> [ <on-2> <off-2> 
[<on-3> <off-3> ]] 


The following command defines the frequency (Hz) for a simple tone. 


CLI (voice-port)> frequency single <300-3400> 


The following command defines a dual frequency tone (where signals of different frequencies are added). 





CLI (voice-port)> frequency dual <300-3400> <300-3400> 
The following command defines a tone where signals of different frequencies are multiplied (frequency 
modulation). 

CLI (voice-port)> frequency modulate <300-3400> <300-3400> 
The following command defines the timeout for incoming call on FXO ports: after receiving a ringing signal, 
the call is disconnected if no ringing signal is received anymore during this time. Default: 6sec. 


CLI (voice-port)> fxo-ringing-timeout <1 - 30sec> 
4.2.3.8 ISDN Specific Parameters 


If configured, the following parameter enables the local generation of a ringback/callback tone in the 
B channel (this command is a workaround for certain bad H.323 implementation in softswitch/media- 
gateways, - only for H.323 -). 


CLI (voice-port)> [no] isdn-ringback-tone 


When an ISDN subscriber is called, some PBX/phone includes the option ‘progress in-band’ in ALERT. 
This has the effect of connecting the B-channel. It is expected that the PBX/ISDN phone generates then 
the ringback tone. Some ISDN phones/PBXs do not. To make up for such bad behavior, the OneOS-based 
voice-capable router can add the local ringback tone to the RTP stream, so that the remote party finally 
hears ringback tone in reverse direction (hence ‘reverse-ringback-tone’). The following parameter must 
NOT be entered as default because the ISDN/PBX ringback signal would be added to the local ringback. 


CLI (voice-port)> [no] isdn-reverse-ringback-tone 
If configured, the following parameter enables the local generation of release tone (network-failure, 


congestion, busy) in the B-channel and the IE Progress-In-Band is inserted in ISDN DISCONNECT 
message. This feature is needed for certain PBXs that never generate the release ringback tone. 


CLI (voice-port)> [no] isdn-release-tone 
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The following command includes the IE ‘progress in-band’ in SETUP-ACK sent by the OneOS-based 
router. This IE may be needed by certain ISDN phone to connect the B-channel and receive the dial-tone 
from the router. 


CLI (voice-port)> [no] isdn-setupack-inband 


The following parameters allow discarding some service requests coming from the ISDN terminal: 
invocations of call forwarding (CFU, CFB, CFNR, and CCBS), call deflection (CD) and call rerouting. 


CLI (voice-port)> [no] isdn-call-forwarding 


CLI (voice-port)> [no] isdn-call-deflection 





CLI (voice-port)> [no] isdn-call-rerouting 


The ISDN call forward invocation (CFU, CFB, and CFNR) is saved by OneOS. A file in flash memory 
contains the phone numbers that requested the CFx service. When the CFx state is saved in OneOS, 
OneOS takes the decision that a call must be forwarded or not when receiving an inbound INVITE 
destined to a number that requested CFx. If OneOS takes the decision to forward the call, OneOS replies 
with the SIP response code '302 Moved' to the caller. The call should be then diverted by the network. 


The CFx state can be viewed by means of the following command: 


CLI> show voice cfx { <voice_port:5/x> | all } 


To remove the saved CFx state: 





CLI> show voice cfx { <voice_port:5/x> | all } reset 
4.2.3.9 Parameters for Dialing 


The following command defines the maximum time for ringing without detecting off-hook. Default: 120sec. 
This command applies only to FXS ports. For ISDN ports please use the T301 timer. 


CLI (voice-port)> max-ringing <1 to 180 sec> 


The following command defines the number of pulse for ringing signal detection on FXO port. Default: 2. 


CLI (voice-port)> ring-number <1 to 40 pulses> 


The following command defines the maximum time (sec) for receiving the first digit. Default: 10sec. 








CLI (voice-port)> dialing-timer <1 to 30 sec> 


The following command defines the idle time (first timer) without receiving a digit to consider the dialing 
completed when timer or timer-or-¢# is selected in the routing table. Default: 4sec. Also, this command 
optionally defines the idle time (second timer) without receiving a digit to consider the dialing completed 
when partial match is used in the routing table (in that case the routing process exits the route with partial 
match when the second timer elapses and continues with other routes). Default: 10sec. 


CLI (voice-port)> end-of-dialing-timer <1 to 30 sec> [<l to 30 sec>] 
The following command enables the second step dialing mode for FXO port only. Default: disable, which 


means incoming dialed digits are processed through the voice routing table. If enabled, the FXO interface 
accepts any incoming call and works as a FXS port for receiving DTMF dialing. 


CLI (voice-port) > second-step-dialing {enable | disable} 


The following command specifies the time between off-hook and the transmission of the first digit for FXO 
interface. Default: 2sec. 


CLI (voice-port) > timeout-—before-dialing <1 to 60 sec> 


The following command defines the transmit level for DTMF digits (dBm). Default: -12 dBm. 


CLI (voice-port)> digit-level <-32 to 0 dBm> 


The following command defines the transmitted DTMF digit duration. Default: 100ms. 








CLI (voice-port)> digit-duration <50 to 1000 ms> 
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The following command defines the minimum delay between two DTMF digits (for transmission towards 
the terminal). Default: 100ms. 


CLI (voice-port)> inter-digit <50 to 1000 ms> 


The following command configures the criterion level for DTMF detection. normal (default) is a good 
compromise between DTMF detection on one hand and voice detection on the other hand, without 
degrading highly the real time performance. severe can be used in some cases when it might happen 
that some fragment of voice talks are interpreted as DIMF. large can be used in some other cases when 
it might happen that some DTMF digits are missing. 


CLI (voice-port)> dtmf-detection-criterion {normal | severe | large} 
4.2.3.10 Analog Message Waiting Indication (MWI) 


The MWI service indicates on a phone LED or on the phone display if there are messages waiting in voice 
mail box (the command analog-mwi disable is deprecated). 


CLI (voice-port)> analog-mwi {disable | enabled [{on-hook-only | specific— 
tone-only}]} [{notification | transition}] 





Default values: enabled on-hook-only and notification 


If enabled, the MWI is provided, in on-hook state by a short ringing signal followed by a modulated signal; 
in off-hook state by a modulated signal and with a specific tone instead of the dial tone. It is possible to 
enable one of these actions only. on-hook-only: the MWI is provided only in the on-hook state. 
specific-—tone-only: the MWI is provided only upon an off-hook event instead of the dial tone (if there 
is at least one message leaving in the mailbox). See table below. 

















CLI command \ voice-port status and tone On-hook Off-hook Specific MWI dial-tone 
Disable NO NO NO 
Enabled YES YES YES 
Enabled on-hook-only YES NO YES 
Enabled specific-tone-only NO NO YES 




















Use the notification mode to send MWI information when receiving SIP NOTIFY message containing 
MWI information. 


Use the transition mode to start MWI information when receiving SIP NOTIFY message containing 
MWI information and when MWI transition (between the state “no message” and the state “at least one 
message”) occurs. This option is used in case of phones which are not able to filter the short ringing signal 
sent for MWI in the on-hook state. 


When the SIP voice mail server is fully RFC compliant, the OneOS-based voice-capable router must issue 
a SUBSCRIBE request to voice mail server so that the voice mail server can send a NOTIFY message 
when voice mails are pending for reading. Under sip-gateway, the following lines must be configured for 
SUBSCRIBE: 


CLI (configure) > sip-gateway 

CLI(sipgw)> [no] voicemail-dns-add <ip-or-hostname> [:<port>] [via <ip- 
address>] 

CLI(sipgw)> [no] subscription-duration <seconds> 


When those two lines are configured, the OneOS-based voice-capable router scans the list of prefix in 
voice-routing and send a SUBSCRIBE for all prefix that are SIP phone numbers (i.e. prefix without wild 
cards and with the ua-sip attribute). 


via is the address of an outbound proxy. Default subscription interval: 1800 seconds. The following timer 
can be also configured (time interval between SIP SUBSCRIBE requests when SUBSCRIBE is not 
positively acknowledged, default: 60 sec): 


CLI (sipgw)> subscription-failed <seconds> 


4.2.3.11 Advice of Charge Parameters 


The following parameters in this section can be not valid if the softswitch does not support them. 
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To configure the Advice of Charge “D” (during the call) information, use the following command. Use the 
forced parameter to force the AOC-D request for any call received on a voice port (analog or ISDN). Use 
the transparent parameter to make the AOC-D request being forwarded. Use the no form of the 
command to disable the AOC-D and have the request being discarded. Default: disabled. 


CLI (voice-port)> [no] aoc-d-service {transparent | forced} 
To configure the Advice of Charge “E” (end of call) information, use the following command. Use the 
forced parameter to force the AOC-E request for any call received on a voice port (analog or ISDN). Use 
the transparent parameter to make the AOC-E request being forwarded. Use the no form of the 
command to disable the AOC-E and have the request being discarded. The optional manage parameter 


enables the process of AOC-E by the OneOS-based voice-capable router itself; this option is used when 
the VoIP network is not able to deliver AOC-E information. Default: disabled. 


CLI (voice-port)> [no] aoc-e-service {transparent | forced} [manage] 
The following parameter defines how the Advice of Charge information is send to the analog terminal on 
FXS port. Default: none. 

CLI (voice-port)> analog-aoc-type {none | 12khz | 16khz | RP | etsi} 


4.2.3.12 Miscellaneous Parameters 


Use the following command to enable (default) or disable the presentation of the name if the information is 
available from the VoIP call leg. When disabled, the name is not presented. Default: enable. 


CLI (voice-port) > calling-name-presentation {enable | disable} 
Use the following command to enable a loop mode on B channel or FXS while the call is connected. This 
feature is commonly used for hardware testing. Default: no loop. 

CLI (voice-port)> [no] loop 
Date and time is sent to local port (analog or ISDN) if the OneOS-based router is connected to a NTP 


server. On ISDN, the date/time is provided in CONNECT message in IE $29. In other words, you need to 
place a successful call from ISDN in order to have the time/date of ISDN phone updated. 


CLI (voice-port)> sntp-time 
Use the following command to enable, if the voice port is in “no shutdown” state, the operational state of 


the port to be taken into account for the state of the front panel “voice” LED. Use the no form to disable the 
process. Default: enable. 


CLI (voice-port)> [no] led-alarm-report 
Use the following command to specify the minimum duration (ms) of the “on-hook” state for the FXO 
interface only. Default: 500ms. 

CLI (voice-port) > on-hook-min-duration <20 .. 10000 ms> 
Use the following command to enable the lifeline bypass if the voice service is not ready (not registered to 


a Gatekeeper or Registrar or call-agent). This parameter is also present in interface BRI parameter group. 
Use the no form to disable the lifeline bypass. Default: disable. 


CLI (voice-port)> [no] life-line-hold 


Note: The command show voice life-line displays the life-line status. 


Use the following command to enable the polarity inversion for FXS ports: the line power polarity is 
inverted upon the call connection. Use the no form to disable the polarity inversion. Default: disable. 


CLI (voice-port)> [no] polarity-inversion 
Use the following command to change the timing parameters for the signals, which must be analyzed on 
FXS interfaces. Three successive states can be defined with a specific duration. 


CLI (voice-port)> sig-conf {on-hook | off-hook | ring | flash | pulse- 
dial} <statel>/<durationl>,<state2>/<duration2>[,<state3/duration3>] 
[<tolerance 10..70>] 
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e state: value 0 is used for “disconnected loop”, value 1 for “connected loop”. 
e duration: inms, from 1 to 10000 ms. 

e tolerance? in % (default 30). 

Example: sig-conf on-hook 1/10,0/400 70 


The On-hook signal will be validated if the OneOS-based voice-capable router detects a stable “connected 
loop” state during 10ms (+ or — 70%) and a stable “disconnected loop” during 400ms (+ or — 70%). 


Default values: On-hook: 1/2, 0/200 
Off-hook: 0/2,1/80 
Hook flash: 1/2, 0/240,1/200 
Ring: obsolete 
Pulse-dial: 0/50,1/50 


The following command defines the impedance type for FXS/FXO interface. 


CLI (voice-port)> impedance {zetsi | 600} 
e  zetsi: compliant with ETSI requirements. 
e 600: 600 Ohm (default value). 


4.2.3.13_ Deprecated Parameters 


The following parameters are not used anymore but remains for configuration compatibility: 


CLI (voice-port)> cas-conft 

CLI (voice-port)> signal-analysis 
CLI (voice-port) > metering 

CLI (voice-port) > user-metering 


CLI (voice-port)> without-—loss-signal 








CLI (voice-port) > coder-law 
4.2.4 BRI Interface 


If a BRI interface is used, it must be enabled by entering the following commands, which allows several 
parameters to be specified for the physical, link or network level. 


Commands for enabling a BRI interface on physical port number 0 (voice module number 5): 


CLI (configure)> interface bri 5/0 
CLI (config-if)> [no] shutdown 
CLI (config-if)> 


The interface must be shut down if a parameter has to be modified. The interface is re-activated with the 
command no shutdown. When an interface is created, the default state is shutdown. 


Enter the following command to enter in the protocol configuration. 


CLI (config-if)> isdn 


By default, the BRI/PRI interfaces use the Euro-ISDN protocol. In order to use EuroNumeris (France- 
specific, called also VN6), the next command has to be used: 


CLI(isdn)> operator {euroisdn | euronumeris} 


Enter the following command to specify the type of interface; it must be set to voip if the interface is used 
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by the H.323 gateway. Default: regular. 


CLI(isdn)> application-interface {bles | regular | voip} 


Enter the following command to specify the maximum number of simultaneous B channels. 


CLI (isdn)> max channels <0..2> 


Enter the following command to specify the protocol emulation for the network level only (level 3). It must 
be set to isdn-nt for ISDN phone, isdn-nt or qsig for a PBX and isdn-te for connection to an ISDN 
network. Default: isdn-te. 


CLI (isdn)> protocol-emulation {isdn-te | isdn-nt | qsig} 


Use the following command to enable the transmission of FACILITY message. Some PBXs do not support 
this type of message. Use the no form to disable the transmission. Default: enable. 


CLI(isdn)> [no] facility 


Use the following command to specify the protocol emulation for the physical layer. It must be configured 
only if the layer 1 emulation must be different than the protocol emulation. Default: identical to protocol 
emulation. 


CLI(isdn)> layerl-emulation {te | nt} 


Use the following command to maintain the ISDN layer 1 up; it is useful for clocking and management. 
Default: no. 


CLI(isdn)> [no] permanent-layerl 


Use the following command to specify the protocol emulation for the layer 2 (LAPD). It must be configured 
only if the layer 2 emulation must be different than the protocol emulation. Default: identical to protocol 
emulation. 


CLI(isdn)> layer2-emulation {te | nt} 


Use the following command to avoid the disconnection of the ISDN layer 2 when the ISDN terminal 
disconnects the layer 2 in static TE! mode; it will be maintained established. Default: no. 


CLI(isdn)> [no] permanent-layer2 


Use the following command to avoid the disconnection of the ISDN layer 2 when there is no call in 
progress in dynamic TEI mode. Default: disconnection enabled. 


CLI (isdn)> no lapd-disconnection-timeout 


Use the following command to specify the TE] management mode. It must be set to dynamic for ISDN 
phones or connection to an ISDN network and static for PBX. Default: dynamic. 


CLI (isdn)> tei-negotiation {dynamic | static} 


Use the following command to define the TEI value in static mode. Default: 0. 


CLI (isdn)> static-tei <0..63> 
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Use the following command to enable the lifeline bypass on the BRI SO voice module. If the interface is 
used by the H323 gateway, the bypass is enabled if the OneOS-based voice-capable router is not 
registered with the gatekeeper (if configured). Use the no form to disable the lifeline bypass (default). 


CLI(isdn)> [no] 1ife-line-hold 


Use the following command to specify the N200 parameter for the link layer. 


CLI (isdn)> n200-counter <counter> 


Use the following command to specify the N202 parameter for the TE] management. 


CLI (isdn) > n202-counter< counter> 


Use the following command to specify the timer T200/T202/T203 values for the link layer. 


CLI (isdn)> t20x-timer <seconds> 


Use the following command to specify the timer T301/T302/T303/T304/T305/T 306/T308/T 309/T310/T313 
values for the network layer. 


CLI (isdn)> t3xx-timer <seconds> 


Use the following command to specify the module for NS/NR (link layer). 
CLI (isdn)> modulo-window {8 | 128} 


Use the following command to specify the parameter K for the link layer. 
CLI (isdn)> k-window <1..128> 


Use the following command to specify the type of B-Channel type sent to the TE. Default: preferred. 


CLI(isdn)> b-channel {preferred | exclusive} 


Use the following command to specify the type of channel for each B channel (1=B1, 2=B2). Several 
commands can be entered to specify several ranges of different types. 


CLI(isdn)> dsO-group { incoming | outgoing | mixed | unused } { all | 
ts <1-2> | from <1-2> to <1-2> } 


Type of channel: 

e incoming: the channel is used only for calls coming from the ISDN device (PBX). 
e outgoing: the channel is used only for calls being sent to the ISDN device. 

e mixed: the channel can be used for incoming and outgoing calls (default value). 


e unused: the channel cannot be used for calls. 


Use the following commands to display the type of each B channel: l=Incoming; O=Outgoing; M=Mixed. 


CLI (isdn)> display 
CLI (display) > ds0O-group 


Note: the Channels #3 to #31 are not used (for PRI only). 
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Use the following command to allow two different methods for B channel allocation (regarding BRI/PRI 
interfaces) Default: first. 


CLI(isdn)> dsQ-alloc {older | first} 


e first: allows B channel allocation from lowest available B channel (default value). 


e older: allows B channel allocation from older available B channel (this method is useful when remote 
Isdn equipment needs a timeout to allow same B channel allocation). 


Use the following command to force the IE Progress-In-Band to be inserted in ISDN ALERT message 
(which forces the B-channel to be connected) and the OneOS-based router to generate locally the 
ringback tone. This function must be used for PBXs that never generate a ringback tone and where the 
network does not provide a ringback tone either. 


CLI(isdn)> [no] alert-ie-progress 


Use the following command to suppress the signal information element for any ALERT message sent to 
the ISDN device. Default: not suppressed. 


CLI(isdn)> no alert-ie-signal 


Use the following command to suppress the channel information element for any ALERT message sent to 
the ISDN device. Default: not suppressed. 


CLI(isdn)> no alert-ie-channel 


Use the following command to suppress the display information element for any message sent to the ISDN 
device. Default: not suppressed. 


CLI(isdn)> no ie-display 


Use the following command to suppress the progress information element for any message sent to the 
ISDN device. Default: not suppressed. 


CLI (isdn)> no ie-progress 


Use the following command to suppress the user to user information element for any message sent to the 
ISDN device. Default: not suppressed. 


CLI(isdn)> no ie-uui 
Use the following command to suppress any PROGRESS message sent to the ISDN device. Default: not 
suppressed. 


CLI(isdn)> no progress 


Use the following command to suppress the HLC information element for any message sent to the ISDN 
device. Default: not suppressed. 


CLI (isdn)> no setup-ie-hlec 


Use the following command to suppress the LLC information element for any message sent to the ISDN 
device. Default: not suppressed. 


CLI (isdn)> no setup-ie-llc 
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Use the following command to define the Q.850 cause when the ISDN line is not operational. It is generally 
used to allow call forwarding. Default: 38 (network out of order). 


CLI(isdn)> unavailability-q850cause {0..127} 


Use the following command to automatically insert an in-band progress indicator information element in a 
DISCONNECT message sent to local port. A tone (depending on the disconnection cause) is sent on the B 
Channel. Use the no form to disable the insertion (default). 


CLI(isdn)> [no] disconnect-ie-progress 


Use the following command to define how to insert the calling name in the SETUP message: calling sub 
address, display IE or Keypad IE. Default: disabled. 


CLI(isdn)> [no] calling-name-ie {origin-sub-address| display| keypad} 


If no channel is available to establish the call, the release cause is by default 34; the release cause can be 
changed as follows: 


CLI (isdn)> channel-unavailable-cause {17 | 34} 


Then, complete the ISDN configuration as follows: 


CLI 
CLI 
CLI 
CLI 


isdn)> exit 
config-if)> execute 
config-if)> exit 
configure) > 


4.2.5 PRI Interface 
If a PRI interface is used, it must be enabled by entering the following commands, which then allows 
several parameters to be specified for the physical, link or network level. 
Commands for enabling an E1 interface on physical port number 0 (voice module number 5): 


CLI (configure)> interface pri 5/0 
CLI (config-if)> [no] shutdown 
CLI (config-if)> 


The interface must be shut down if a parameter has to be modified. The interface is re-activated with the 
command no shutdown. When an interface is created, then default state is “shutdown”. 


Use the following command to specify the interface type of voice interface as E1 or T1 (default: E1). 


CLI (config-if)> physical-interface {E1|T1} 


Use the following command to specify the framing type. 
CLI (config-if)> framing { none | df | mf | emf | sf | esf } 
e none: no framing. Only used for CES / unstructured mode. 
e df: double frame, no CRC4. For E1 only. (Default value). 
e mf: multiframe (CRC4). For E1 only. 


e emf: extended multiframe (CRC4). For E1 only. 
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e sf: super-frame (for T1 only). 


e esf: extended super frame (for T1 only). 


Use the following command to specify the physical line coding to be used (default: hdb3). 
CLI (config-if)> linecode { ami | hdb3 | b8zs } 


Use the following command to enter in the protocol configuration. 


CLI (config-if)> isdn 


Use the following command to specify the type of interface. It must be set to VoIP if the interface is used 
by the H323 gateway. Default: data. 


CLI(isdn)> application-interface { voip | voatm | data } 


Use the following command to specify the maximum number of simultaneous B channels. 


CLI (isdn)> max channels <0..30> 


By default, the BRI/PRI interfaces use the Euro-ISDN protocol. In order to use EuroNumeris (France- 
specific, called also VN6), the next command has to be used: 


CLI(isdn)> operator { euroisdn | euronumeris } 


Use the following command to specify the protocol emulation for the network level only (level 3). It must be 
set to isdn-nt for ISDN phone, isdn-nt or gsig for a PBX and isdn-te for connection to an ISDN 
network. Default: isdn-te. 


CLI (isdn)> protocol-emulation { isdn-te | isdn-nt | qsig } 


Use the following command to specify the protocol emulation for the layer 2 (LAPD). It must be configured 
only if the layer 2 emulation must be different than the protocol emulation. Default: identical to protocol 
emulation. 


CLI(isdn)> layer2-emulation { te | nt } 


Use the following command to specify the N200 parameter for the link layer. 


CLI (isdn)> n200-counter <counter> 


Use the following command to specify the N202 parameter for the TE] management. 


CLI (isdn)> n202-counter < counter> 


Use the following command to specify the timer T200/T202/T203 values for the link layer. 


CLI (isdn)> t20x-timer <seconds> 


Use the following command to specify the timers T301/T302/T303/T304/T305/T306/T308/T309/T310/T313 
for the network layer. 


CLI (isdn)> t3xx-timer <seconds> 
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Use the following command to specify the module for NS/NR (link layer). 
CLI (isdn) > modulo-window {8 | 128} 


Use the following command to specify the parameter K for the link layer. 
CLI (isdn)> k-window <1..128> 


Use the following command to specify the type of B-Channel type sent to the TE. Default: preferred. 


CLI(isdn)> B-channel { preferred | exclusive } 


Use the following command to specify the type of channel for each B channel (except #16, reserved for 
signaling). Several commands can be entered to specify several ranges of different types. 


CLI(isdn)> dsO-group { incoming | outgoing | mixed | unused } { all | 
ts <1-31> | from <1-31> to <1-31> } 


Type of channel: 

e incoming: the channel is used only for calls coming from the ISDN device (PBX). 
e outgoing: the channel is used only for calls being sent to the ISDN device. 

e mixed: the channel can be used for incoming and outgoing calls (default value). 


e unused: the channel cannot be used for calls. 


Use the following commands to display the type of each B channel: l=Incoming; O=Outgoing; M=Mixed. 


CLI (isdn)> display 
CLI (display) > ds0-group 








ts Up BME Qin See AIS RB SUE Se Thee SBE eh 0 Os ee SAO) te 1ST: 12 Ls 14 15 16 
type M M M I I I I I M M M M M M M x 
ts Lh 18 19 20 21 22 23 24 25 26 27 28 29 30 Si 
type M M M M M M M M M M M M M M M 


Use the following command to allow two different methods for B channel allocation (regarding BRI/PRI 
interfaces) Default: first. 


CLI(isdn)> dsO-alloc { older | first } 


e first: allows B channel allocation from lowest available B channel (default value). 


e older: allows B channel allocation from older available B channel (this method is useful when remote 
Isdn equipment needs a timeout to allow same B channel allocation). 


Use the following command to force the IE Progress-In-Band to be inserted in ISDN ALERT message 
(which forces the B-channel to be connected) and the OneOS-based router to generate locally the 
ringback tone. This function must be used for PBX that never generate a ringback tone and where the 
network does not provide a ringback tone either. 


CLI(isdn)> [no] alert-ie-progress 


Use the following command to suppress the signal information element for any ALERT message sent to 
the ISDN device. Default: not suppressed. 


CLI(isdn)> no alert-ie-signal 
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Use the following command to suppress the display information element for any message sent to the ISDN 
device. Default: not suppressed. 


CLI(isdn)> no ie-display 


Use the following command to suppress the progress information element for any messags sent to the 
ISDN device. Default: not suppressed. 


CLI(isdn)> no ie-progress 


Use the following command to suppress the user to user information element for any message sent to the 
ISDN device. Default: not suppressed. 


CLI(isdn)> no ie-uui 


Use the following command to suppress any PROGRESS message sent to the ISDN device. Default: not 
suppressed. 


CLI(isdn)> no progress 


Use the following command to suppress the HLC information element for any message sent to the ISDN 
device. Default: not suppressed. 


CLI(isdn)> no setup-ie-hlc 


Use the following command to suppress the LLC information element for any messages sent to the ISDN 
device. Default: not suppressed. 


CLI (isdn)> no setup-ie-llc 


Use the following command to define the Q.850 cause when the ISDN line is not operational. It is generally 
used to allow call forwarding. Default: 38 (network out of order). 


CLI(isdn)> unavailability-q850cause {0..127} 


Use the following command to automatically insert an in-band progress indicator information element in a 
DISCONNECT message sent to local port. A tone (depending on the disconnection cause) is sent on the B 
Channel. Use the no form to disable the insertion (default). 


CLI(isdn)> [no] disconnect-ie-progress 


If no channel is available to establish the call, the release cause is by default 34; the release cause can be 
changed as follows: 


CLI (isdn)> channel-unavailable-cause {17 | 34} 


Then, complete the ISDN configuration as follows: 


CLI ( 
CLI (config-if)> execute 
CLI (config-if)> exit 
CLI (configure) > 


isdn)> exit 
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4.2.6 


4.2.6.1 


Internal Local Voice Port (POTS) 


The command for the creation of a local POTS port associated with the 5/0 physical port is: 


CLI (configure)> dial-peer voice pots 1 
CLI (pots)> port 5/0 





Each dial-peer voice pots must be identified by an arbitrary index from 0 to N. The physical port numbering 
is defined in the product installation manual. 


Parameters 


Use the following command to indicate the group the port belongs to. In a group all the ports have the 
same phone number. Default: the port belongs to pots-group 0 with priority defined in priority 
command. 


CLI (pots)> pots-group <0..30> [priority <0..30>] 


Use the following command to optionally indicate the voice group the port belongs to. A voice group can 
contain POTS and VoIP ports. 


CLI (pots)> [no] voice-group <0..30> [priority <0..30>] 


Use the following command to define the default priority of the port in the group (if not defined in the 
pots-group Of voice-group command). In the group all the interfaces with the same priority are 
selected circularly (round robin) or according to the load (load balancing). Default: 0. 


CLI (pots)> priority <0..30> 


Use the following command to enable the suppression of the calling number for calls coming from the 
device attached to the port. The length value ranges from 1 to 35. 


CLI (pots)> suppress-calling-number <length> 


Use the following command to insert a number at the beginning of the calling number for calls coming from 
the device attached to the port. If supp-calling-—number is enabled, the specified number replaces the 
calling number. The number is made of 1 to 35 (0-9, #, *) characters. 


On FXS interfaces with SIP, this argument is mandatory; otherwise the calling number in the ‘from:’ 
and ‘contact:’ field will be empty. 


CLI (pots)> insert-calling-number <number> 


Use the following command to enable a direct call to the specified number when detecting an off-hook (for 
analog ports only). The number is made of 1 to 35 (0-9, #, *) characters. 


CLI (pots) > direct-call <number> 


Use the following command to enable implicit routing. All the incoming calls are routed to the specified 
dial-peer pots-group or dial-peer voip without any analysis of the destination number. 


CLI (pots)> implicit-routing { pots-group | voip } <identifier> 


Use the following command to specify the emergency level for any call arriving on this port. Default: 100. 


CLI (pots)> emergency <1. .200> 
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Use the following command to define the bearer capability to be used for inbound call coming from FXS 
ports only. Default: voice. 


CLI (pots)> bearer-cap { voice | voice-band | unrestricted } 


Use the following command to define the maximum number of simultaneous voice calls. 


CLI (pots)> max-conn <1..30> 


This parameter depends on interface type: 
ISDN BRI: 3 calls (2 with B-channel + 1 without channel) [default: 3] 


ISDN PRI: 30 calls [default: 30] 
FXS: 2 calls with intelligent profile, otherwise 1 call [default: 2] 
FXO: 1 call [default: 1] 


4.2.7 H.323 Gateway 


The following command enters the global parameters configuration for the H.323 gateway: 


CLI (configure) > h323-gateway 
CLI (h323gw) > 





Use the following command to shutdown the H.323 gateway. Changes on some parameters concerning 
the H.323 gateway require a shutdown/no shutdown operation. After a "shutdown", the gateway sends a 
deregistration request. Default: shutdown. 


CLI (h323gw)> [no] shutdown 


Use the following command to define the IP interface attached to the H.323 gateway (may be Ethernet, 
FastEthernet, ATM, PPP...). The IP address of the H.323 gateway (for registering to a gatekeeper, for 
example) is the IP address configured for this interface (if the gw-address command parameter is 
configured implicit). 


If the intrusive option is enabled, the H323 gateway is started when the IP interface goes up and is 
deactivated if the IP interface becomes down (all the current calls are cleared). If the monitoring option 
is also enabled, the H323 gateway is started when the dialer watch-list goes up and is deactivated if the 
dialer watch list becomes down (all the current calls are cleared). The dialer watch-list monitoring is more 
precise than the simple interface monitoring. 


CLI (h323gw)> [no] gw-interface <source-interface> <unit> [intrusive 
[monitoring dialer-watch-list <list-—name>]] 


Use the following command to specify if the IP address of the h323 gateway is the one of the interface 
defined by the gw-interface command or another one acquired by the autoconfiguration process (See 
OneOS User Guide for data services). Default: implicit. 


CLI (h323gw)> gw-address {implicit | autoconfig} 


Use the following command to configure the gatekeeper identifier and IP address. Both parameters are 
optional: if the IP address is not configured, the automatic discovery is enabled. To work without a 
gatekeeper, no gatekeeper must be entered (default value). 





CLI (h323gw)> [no] gatekeeper [id <gatekeeper-identifier>] [ipaddr <IP- 
address>:<RAS port>] 


Use the following command to set the alternate gatekeeper mode. If dynamic, the OneOS-based voice- 
capable router takes into account the list of alternate gatekeeper given by the gatekeeper in the RAS 


Page 4.2-75 of 166 


ONEOS V4.2R5 Voice USER GUIDE (EDITION 5) 


protocol. If static the configured list is used. Default: static. 
CLI (h323gw)> altgk-mode {static | dynamic} 


Use the following command to specify a timer for checking the primary gatekeeper when the device is 
registered with an alternate gatekeeper. Use the no form to disable the periodic checking (default). 


CLI (h323gw)> [no] altgk-timeout <seconds> 


Use the following command to enter in the alternate gatekeeper list configuration. 


CLI (h323gw)> altgk-list 
CLI (h323gw-altgk) > 


Then, use the following command to configure an alternate gatekeeper with a priority (default: 127), an 
identifier, an IP address, and “needed” if the registration must be maintained. Use the no form with index 
to suppress a gatekeeper. The enter exit to return to the H.323 gateway configuration mode. 
CLI (h323gw-altgk)> [no] altgk <index 1-5> [priority <1-127>] id <gk- 
identifier> address <IP-addr>:<RAS-port> [register {needed | no}] 


CLI (h323gw-altgk)> exit 


Use the following command to configure a backup gatekeeper (same parameters as above). This 
command equivalent to the altgk-list above is deprecated and remains for compatibility. 





CLI (h323gw)> alt-gatekeeper id <gatekeeper-identifier> ipaddr <IP- 
address>:<RAS-—port> 


Use the following command to enable the Resource Management using the RAS RAI procedure. The 
criteria may be the B Channel allocation ratio or the bandwidth (defined in 4.1.5.2) ratio or both. Two 
thresholds are defined: a low water mark and a high water mark (in percentage). 


CLI (h323gw)> [no] resource threshold {all | dsO | bandwidth} high <0-100> 
low <0-100> 


Use the following command to link h323 gateway and voice port status. 


CLI (h323gw)> [no] ras-intrusive-voiceport {registration-status | both- 
way} {and-mode | or-mode} {5/0,5/2... ,voip/0,...} 


e Impact of the port status on the registration: and—mode means that all the specified ports must be up 
for starting the registration; or—mode means that the registration process will start if one or more of 
the ports are up. 


e both-way forces a bi-directional intrusive mode. If H.323 is not registered, the list of ports is set down 
and if the list of ports is not up, the H.323 gateway is de-registered. 


e Impact of the registration status on the voice port status: registration-status means that the 
specified ports are deactivated when the h323 gateway is not registered. 


e The list of ports includes ISDN voice ports (5/0, 5/1, ...) or VOIP trunks to an IP-PBX (voip-group 
0, voip-group 1,...). 


Use the following command to force the state of the number portability function. The timeout parameter is 
optional and specifies the duration of the “in-progress” state. The default value is 96 hours. Use the no 
form to disable the portability function (default). 


CLI (h323gw)> set-portability {enable | in-progress | done} [timeout 
<time-in-hours 1-1500>] 
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Use the following command to define the H323 identifier for the gateway (optional). The identifier is a 1 to 
40 characters length string. 


CLI (h323gw) > h323-id <string> 


Use the following command to define the email identifier for the gateway (optional). The identifier is a 1 to 
40 characters length string. 


CLI (h323gw)> email-id <string> 


Use the following command to define the gateway prefix indicated in the registration message. The 
number is made of 1 to 35 (0-9, #, *) characters. 


CLI (h323gw) > gw-prefix <number> 


Use the following command to define the IP multicast address and port for gatekeeper discovery (default: 
204.2.3.41:1718). 


CLI (h323gw)> ras-multicast <IP-address>:<port> 


Use the following command to define the UDP port used for RAS protocol (default: 1719). 
CLI (h323gw)> ras-port <0-65535> 


Use the following command to define the H.225/Q.931 listening TCP port (default: 1720). 
CLI (h323gw)> callsig-port <0-65535> 


Use the following command to enable (disable) the TCP keepalive procedure for H323 sessions. Default: 
enable. 


CLI (h323gw)> [no] tcp-keepalive 


Use the following command to define the UDP port range used for RTP (each 0-65535). Default 16384- 
16482. 


CLI (h323gw)> rtp-port-range min <0-65535> max <0-65535> 


Use the following command to force the use of the same ports RTP and RTCP in case of new codec or 
T38 negotiation during the communication. 


CLI (h323gw)> [no] fixed-media-port 


Use the following command to define the RTP payload type value (ex: 101) for Unrestricted Data flows 
(UDI 64K). Default: G.711 value. 


CLI (h323gw) > payload-64k-unrestricted <0-255> 


Use the following command to define the timeout for the response to a SETUP message Default: 10 sec. 
CLI (h323gw) > q931-response-timeout <1-300> 
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Use the following command to define the timeout for receiving CONNECT message. Default: 10 sec. 


CLI (h323gw) > q931-connection-timeout <1-300> 


Use the following command to define the timeout used for RAS protocol. Default: 10 sec. 


CLI (h323gw)> ras-response-timeout <1-300> 


Use the following command to define the retries number in case of no response coming from the 
gatekeeper before trying the alternate gatekeeper. Default: 3. 


CLI (h323gw)> ras-max-retries <1..200> 


Use the following command to define the time-to-live value indicated in the Registration Request. Default: 
60 sec. 


CLI (h323gw)> ras-timetolive <1..300> 


Use the following command to define the timeout value for light registration retries. It must be lower than 
the time to live. Default: 45 sec. 


CLI (h323gw)> ras-keepalive-timeout <1..200> 


If H.235 is used and the server does not require full registration, light re-registration is sent by the OneOS- 
based device. Use the following command to force full RAS registration periodically after the timeout 
defined in the command. Use the no form to use light re-registration (default). 


CLI (h323gw)> [no] ras-full-reg-timeout <timeout> 


Use the following command to define the timeout used for H.245 protocol. Default: 10 sec. 
CLI (h323gw) > h245-response-timeout <1-300> 


Use the following command to enable the transmission of RAS Bandwidth Requests messages toward the 
Gatekeeper for bandwidth control. Default: disabled. 


CLI (h323gw)> [no] ras-bandwidth-control 


Use the following command to force the registration and the unregistration. Unregistration must be done 
before a reboot to keep a correct registration state in the gatekeeper. 


CLI (h323gw)> {register | unregister} 


Use the following command to discard the facility start h245 sent by the remote. 
CLI (h323gw)> [no] start-—h245-discarded 


Use the following command to enable the H.235 authentication procedure for RAS. The optional parameter 
type allows hiding the password in the CLI text file and for a show running-config command. The 
type ‘0’ indicates that the password must be encrypted. The type ‘1’ indicates that the password is 
encrypted. If type is absent, the password is not encrypted. If the password is entered in clear mode with 
type=0, it will appear encrypted with type set to 1 in the configuration file. Default: h235 disable. 


CLI (h323gw)> [no] h235-authentication <username> <password> [<type>] 
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Use the following command to perform three test calls after successful H.323 gateway registration. The 
H.323 call is placed through the gatekeeper using the calling and called phone number provided as 
command arguments. If, at least, one of the three successive calls is successful (as far as signaling for call 
establishment is concerned), the voice gateway of the router is considered operational and the LED 
marked "Voice" is green. Otherwise, the LED is red, until a successful voice call goes through (call initiated 
by a local subscriber). 


CLI (h323gw)> call-test called <el64-number> calling <e164-number> 


Use the following command to enable a specific format for the SNMP sysdescr object with a description 
of the voice hardware configuration. Default: disabled. 


CLI (h323gw)> [no] snmp-sysdescr-hw-ident 


Use the following command to enable (disable) the TCP keepalive procedure for H323 sessions. Default: 
enable. 


CLI (h323gw)> [no] tcp-keepalive 


Some firewalls / SBC may not allow re-negotiating another RTP port when a call is established. When the 
‘fixed-media-port’ option is set, the same RTP port is used even if the codec is re-negotiated or if the 
communication switches to T.38. (Default: no fixed-media-port). 


CLI (h323gw)> [no] fixed-media-port 


Use the following command for a debug purpose only. It must not be used in normal conditions. 
CLI (h323gw)> polling 


Example: 
CLI (configure) > h323-gateway 
CLI (h323gw)> gw-interface ATM 0.1 
CLI (h323gw)> gatekeeper id ZONE1 ipaddr 10.2.2.1:1718 
CLI (h323gw) > alt-gatekeeper id ZONE1 ipaddr 10.3.2.1:1718 
CLI (h323gw)> h323-id GW1 
CLI (h323gw)> gw-prefix 20# 
CLI (h323gw)> ras-multicast 204.2.3.41:1718 
CLI (h323gw)> ras-port 1719 
CLI (h323gw) > callsig-port 1720 
CLI (h323gw)> rtp-port-range 32000 36000 
CLI (h323gw)> rtp-dscp 63 
CLI (h323gw) > q931-response-timeout 10 
CLI (h323gw) > q931-connection-timeout 10 
CLI (h323gw)> ras-response-timeout 10 
CLI (h323gw) > h245-response-timeout 10 
CLI (h323gw)> no shutdown 








Page 4.2-79 of 166 


ONEOS V4.2R5 VOICE USER GUIDE (EDITION 5) 


4.2.8 SIP Gateway 
4.2.8.1. | Global SIP Gateway Parameters 
The following command enters the global parameters configuration for the SIP gateway: 


CLI (configure) > sip-gateway 
CLI (sipgw) > 





Use the following command to shutdown the SIP gateway. Changes on some parameters concerning the 
SIP gateway require a shutdown/no shutdown operation. After a "shutdown", the gateway sends a 
deregistration request. Default: shutdown. 


CLI (sipgw)> [no] shutdown 


Global Parameters for Signaling 


Use the following command to define the IP interface attached to the SIP gateway (may be Ethernet, 
FastEthernet, ATM, PPP...). The IP address of the SIP gateway (for registration for example) is the IP 
address configured for this interface. 


If the intrusive option is enabled, the SIP gateway is started when the IP interface goes up and is 
deactivated if the IP interface becomes down (all the current calls are cleared). If the monitoring option 
is also enabled, the SIP gateway is started when the dialer watch-list goes up and is deactivated if the 
dialer watch list becomes down (all the current calls are cleared). The dialer watch-list monitoring is more 
precise than the simple interface monitoring. 


CLI(sipgw)> [no] gw-interface <source-interface> <unit> [intrusive 
[monitoring dialer-watch-list <list-—name>]] 


Use the following command to define the UDP listening port for SIP. Default: 5060. 
CLI (sipgw)> callsig-port <port> 


Use the following command to define the DSCP field value for transmitted SIP packets. Default: 0. 


CLI (sipgw)> sig-dscp <0-63> 


Parameters for Registration 


Use the following command to define an optional outbound-proxy. If enabled, all the SIP messages 
(signaling and registration) are sent to the specified IP address. If not used, the messages are sent to the 
configured SIP proxy and registrar. Default: not used. 


CLI(sipgw)> [no] outbound-proxy <IP-address or domain-name> 


Use the following command to define the registrar IP address or name (default port 5061). The “via” 
optional parameter defines an outbound proxy (all the registration messages will be sent to this address). 


CLI(sipgw)> [no] reg-dns-add {<ip-address>[:<port>] | <dns-name>} [via 
<ip-address>] 


Use the following command to configure the time interval between keepalive to check access to the 
registrar. interval is provided in second granularity. Default: 1800 (1800 sec). 


CLI (sipgw)> reg-ka <interval> 
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The default mode is to reregister according to the "expires" value (or the reg—ka value if "expires" is not 
used). Use the following command to specify a custom behavior of the re-registration process. 


CLI(sipgw)> [no] reg-ka-mode {percent | fixed | minus} <value-less> 


[limit <value> {percent | fixed | minus} <value-more>] 


If limit is not specified the timer interval is calculated from the "expires" value (value-less% of 
"expires" or fixed value-less value or "expires" minus value-less). 


If limit is specified the timer interval is calculated depending on the relative values of limit and 

"expires". 

e If “expires” is lower than limit the timer interval is calculated from the "expires" value (value- 
less% of "expires" or fixed value-less value or "expires" minus value-less). 


e If "expires" is greater than limit the timer interval is calculated from the "expires" value (value- 
more% of "expires" or fixed value-—more value or "expires" minus value-more). 





Example: reg-ka-mode percent 50 limit 1200 minus 600 means that the re-registration timer is 
50% of "expires" if "expires" is less than 1200 or "expires" minus 600 if "expires" is more than 1200. 


Use the following command to configure the SIP proxy IP address or name. The “via” optional parameter 
defines an outbound proxy (all the signaling SIP messages will be sent to this address). 


CLI(sipgw)> [no] prox-dns-add {<ip-address>[:<port>] | <dns-name>} [via 
<ip-address>] 


Use the following command to configure the time interval between keepalive to check access to the proxy. 
Default: 1800 sec (30 minutes). 


CLI (sipgw)> prox-ka <seconds> 


Use the following command to configure the default SIP identifier for registration. sip-username is a 
string of up to 35 characters long. It is used if there are no routing rules with the ua-sip option. Note: the 
command sip-—id is deprecated. 


CLI(sipgw)> [no] sip-username <string> 


Use the following command to force the use of a DNS name instead of an IP address in REGISTER and 
INVITE. device-host-—name is a string of up to 35 characters long. Use the no form to have the IP 
address of the interface attached to the SIP gateway used. Note: the command sip-host-name is 
deprecated. 





CLI(sipgw)> [no] device-host-name <dns-—name> 


Use the following command to configure the default SIP username and password for authentication. User 
name and password are strings of up to 15 characters. sip-authentication can be used for 
registration and invite authentication. For registration authentication the command must be added in the 
ua-sip route while for invite registration the command must be added in the non ua-sip route. See an 
example in 4.3.2. Note: If sip-authentication is used, the command sip-—username is deprecated. 


CLI(sipgw)> [no] sip-authentication <username> <password> 


Tuning of SIP Messages 


Use the following command to enable the SIP trunking mode. For outbound INVITE message, a P- 
Preferred-id header is added with the name indicated by sip-username and there is only one Registration 
session for the trunk (the routing table is not checked for multiple registrations). Default: disable. 


CLI(sipgw)> [no] trunking-mode 


Page 4.2-81 of 166 


ONEOS V4.2R5 VOICE USER GUIDE (EDITION 5) 


Use the following command to specify if the hostname (if configured) or the IP address must be used in the 
“Contact” header field. Default: hostname if configured otherwise the IP address of the interface attached 
to the SIP gateway will be used. 


CLI (sipgw)> uri-contact {ip-address | hostname | contact-string <string>} 


Use the following command to specify if the hostname (if configured) or the IP address must be used in the 
“From” header field. Default: hostname if configured otherwise the IP address of the interface attached to 
the SIP gateway will be used. 


CLI (sipgw)> uri-from {ip-address | hostname} 


Use the following command to allow to send the BYE message when REFER is received. This behavior is 
required by some SIP proxies. Default: disable. 


CLI(sipgw)> [no] bye-on-refer 


Use the following command to allow to send the BYE message when a 202 OK is received (after having 
sent a REFER). Default: enable. 


CLI (sipgw)> [no] bye-on-refer-—accept 


Use the following command to customize OneOS behavior for certain softswitch. When choosing 
broadworks, their proprietary management of call-waiting tone and hookflash is activated. 


CLI (sipgw)> softswitch-profile {default | broadworks} 


Use the following command to include the field user agent in SIP headers; this can be useful for certain 
softswitch to apply varying processing based on the product manufacturer or hostname. If included, the 
default is to include the manufacturer information in user-agent field. Default: exclude. 


CLI (sipgw)> user-agent {include [hostname | manufacturer] | exclude} 


Use the following command to make any call aimed to be routed towards SIP Gateway interface to be 
checked. It must have its calling number registered and, as a consequence, must be known by the SIP 
Registrar/proxy at the remote endpoint of the current SIP Gateway interface. By default the checking is 
active. 


CLI (sipgw)> [no] calling-number-checking 


By default, the * and # digits are sent as is in URI. For compliance with the standards, use the following 
command to transform * and # with escape characters (%<ascii-code>). 


CLI(sipgw)> [no] sip-uri-escape 


A 3xx response code to an INVITE means that the sip-gateway should attempt another INVITE to a moved 
location. By default, the response code ‘302 Moved’ is supported. Use the following command to clear the 
call upon receiving 3xx response. 


CLI (sipgw)> [no] discard-3xx 


Use the following command to define a specific URI that is received in the "From" field of any incoming 
INVITE for the CLIR service. The default value (as recommended in the standard) is 


anonymous@anonymous. invalid. 


CLI(sipgw)> [no] clip-privacy-uri <uri> [incoming | outgoing | both-way] 
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Use the following command to define the URI that, if contained in the "From" field, makes the CLIP service 
to be not offered. The value depends on the SIP provider (not standardized). Default value: empty. 


CLI(sipgw)> [no] clip-unsubscribe-uri <uri> 


Use the following command to force the "From" field to anonymous@anonymous. invalid in case of CLIR 
service on outgoing calls, for each outgoing call. This feature can be used if the softswitch does not 
support privacy-id header, which is the recommended way to provide CLIR service. Default: disable. 


CLI(sipgw)> [no] presentation-restricted 


Use the following command to define how the called number of an inbound SIP call is extracted. After 
called number extraction, the call is routed by voice-routing taking into account that called number. The 
default behavior is uri. With this behavior, the request URI line is first examined. If it contains a well- 
formatted phone number, it is used as called number, otherwise, the "To" field is then examined. 


If to is configured the called number is directly extracted from the "To" field. 


CLI (sipgw)> sip-called-number {uri | to} 


Use the following command to force in SIP request message, the from-display-string information contained 
in From IE. 


CLI (sipgw)> [no] sip-from-display <string-up-to-50-char> 


Use the following command to insert the calling information into P-asserted-id field in SIP request 
message. This option is used for the CLIP service when the network is not able to check and assert the 
calling number. 


CLI(sipgw)> [no] sip-asserted-id 


Use the following command to define the request URI for the Conferencing Bridge. See 4.2.8.2.2.6 for 
more details. 


CLI(sipgw)> [no] bridge-uri-host <hostname-or-ip> 


Use the following command to enable a Broadworks specific mode to transport the hookflash event in SIP. 
Default: disable 


CLI (sipgw)> [no] privacy—-hookflash 


The following command is deprecated. 


CLI(sipgw)> [no] message-waiting-indication 


SIP Timers 


Use the following command to define in seconds the time-out to get a final response to an INVITE. If the 
timeout is 0, the "Expire" field of the INVITE request is removed. The main interest of reducing this timer is 
to detect earlier that an INVITE fails; then, voice-routing can re-route the call to a backup destination. 


CLI (sipgw)> invite-method-timeout <seconds> 


Use the following command to define in seconds the request time-out for a SIP message sent without a 
remote answer. The message is resent with a time interval that is doubled at every retransmission (first 
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timeout is 500 ms) and so repetition is executed until the global timeout is expired. The command is 
applicable to any SIP request and especially for INVITE. By default, the timer is 32 sec. Use the no form to 
restore the default timer. The main interest of reducing this timer is to detect earlier that an INVITE fails; 
then, voice-routing can re-route the call to a backup destination. 


CLI(sipgw)> [no] request-primitive-timer <seconds> 


Use the following command to define in hours the maximum duration of a SIP communication. Default 
value: 18 hours. Use the no form to disable the bye timer. 


CLI(sipgw)> [no] bye-timer <duration 0-24h> 


Use the following command to define, for an outgoing call, the maximum time between reception of 1xx 
message (except 100 trying) and 200 OK. Default value: 180 sec. Use the no form to disable the connect 
timer. 


CLI (sipgw)> [no] connect-timer <duration 60-300s> 


Use the following command to define, for an outgoing call, the maximum time between the transmission of 
INVITE and the reception of 1xx message (except 100 trying) or 200 OK. Default value: 32 sec. Use the 
no form to disable the invite response timer. 


CLI(sipgw)> [no] invite-response-timer <duration 10-50s> 


Use the following command to define the timer used to send again a registration request, in case of 
reception of 4xx, 5xx, 6xx message. Default: 4 sec. 


CLI (sipgw)> reg-failure-timer <duration 1-50s> 


Use the following command to define the duration between two registration request sequences (max- 
retry-nb successive registration requests within the period defined buy request-primitive-timeout). 
Default: 1 sec and 0 retry. 


CLI (sipgw)> reg-interval-timeout <duration 1-43200s> max-retry-nb <0-30> 


Use the following command to define the timer used to go to the unregistered state in case of no reply of 
registration requests sent for keep-alive. Default: 3 sec. 


CLI (sipgw)> [no] registration-timeout <duration 1-30s> 


RTP Parameters 
Use the following command to define UDP port range used for RTP (each 0-65535). Default 16384-16482. 
CLI (sipgw)> rtp-port-range <0-65535> <0-65535> 


By default, ISDN calls with unrestricted bearer capability are transported via a G.711 codec over IP. Use 
the following command to override the default RTP payload type value for unrestricted data flows (UDI 
64K). The command was created as a workaround for interoperability with non-standard compliant 
gateways. 


CLI (sipgw)> [no] payload-64k-unrestricted <0-255> 


Use the following command to define the DSCP field value for transmitted RTP packets (0-63). Default: 0. 
CLI (sipgw)> rtp-dscp <0-63> 
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Intrusive mode 


Use the following command to enable to map the sip gateway status with the voice-port status. It is used 
for alarm device on FXS port (with the FXS power drop) or to allow an ISDN PBX to backup the calls on 
other ISDN lines. 


CLI(sipgw)> [no] intrusive-voiceport {atm-if-status | sip-gateway-if- 
status | registration-status | registration-error | port-—registration-— 
error} <5/x,5/y,5/z> 

The following conditions are tested: 


e atm-if-status: the ATM line status is checked. This option may be used if the SIP gateway is not 
attached to an ATM interface but if the SIP traffic goes through the ATM link. 


e sip-gateway-if-status: the IP interface attached to the sip gateway is checked. 


e registration-status: the SIP gateway is considered as not operational if all the phones (and, if 
configured, the sip gateway global registering) are not registered. 


e registration-error: the SIP gateway is considered as not operational if one of the phones is not 
registered. 


e port-registration-error: only the designated ports are affected (FXS power drop) when the 
SIP gateway is considered as not operational (because of the above conditions). 


e §=6<5/x,5/y,5/z>: list of voice ports which are handled. 


4.2.8.2. FXS Supplementary Services 
4.2.8.2.1_ Configuring FXS Voice Features 


By default, an FXS line can manage only one SIP call. Advanced voice features can be provided by a 
softswitch, if the softswitch manages internally the voice features and especially the connection of this FXS 
line with multiple subscribers (hold, retrieve, conference ...). 


In order to be softswitch-independent, the FXS line can be configured to be "intelligent", which means call 
control intelligence is in OneOS gateway. Per FXS line, we can manage two calls, where one call is active 
and the other is on-hold. If 3-way conference is started, the conference is realized in OneOS gateway. 


To configure an FXS line in "intelligent" mode (default: disable): 


CLI (configure)> voice-port 5/<x> 
CLI (voice-port)> analog-user-profile {intelligent | non-intelligent} 





Use the following command to set the way explicit call transfer is made. In double call state, the user can 
either hook on or press hookflash (R key) and a number. Call transfer is active only if analog-user-profile is 
set to intelligent: 


CLI (voice-port)> analog-ect { on-hook | flash <y>} 


Use the following command to force the calling number header for the Call Line Identification Restriction 
complementary service. See 4.1.4.6 for permitted values. It is also possible to enable this feature in the 
voice routing table. 





CLI (voice-port)> force-clir <presentation-code> <screening-—code> 


Use the following command to configure the profile which defines the keypad sequence for Call forwarding 
(CFU, CFB, and CFNR). 


CLI (voice-port)> [no] dialed-supp-service-profile <0..4> 


For every call forwarding type, 3 keypads must be defined: one for activation, one for de-activation, one for 
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checking (interrogating) the call forward status). The profile is defined in the voice-global parameter group: 


voice-global 
dialed-supp-service-profile <x> 
cfu activation <string> deactivation <string> checking <string> 
cfb activation <string> deactivation <string> checking <string> 
cfnr activation <string> deactivation <string> checking <string> 
exit 
exit 


The string must be not routable in the voice-routing table; a check is done while the CLI command is 
entered. 


Example: cfb activation *55# deactivation *55* checking #55# 


When the analog-user-profile is set to intelligent, the 3-pty conference can be managed internally. Should 
the conference be managed in an external bridge, the 3pty service must be configured as follows: 


CLI (configure)> voice-port 5/<x> 

CLI (voice-port)> 3pty-service {internal | external bridge-number <bridge- 
phone-number>} 

CLI (voice-port)> exit 

CLI (configure)> sip-gateway 

CLI(sipgw)> [no] bridge-uri-host <hostname-or-ip> 





bridge-phone-number is the number included in request URI and "To" field. hostname-or-ip is the 


hostname or IP for INVITE request URI/"To" ("To" field is bridge-phone-number@hostname-or-ip). 


3-way conference with an external bridge works as follows: 


e The FXS subscriber must be connected to two other SIP subscribers (user B and C) where one call 
leg is on-hold. 


e The FXS subscriber decides to activate 3-way conference and dials R3 
e OneOS initiate a first call to the conference bridge (a simple call to the bridge-phone-number). 


e XS is connected with the audio stream from/to this conference bridge and sends a REFER to user B 
and C so that B and C connects to the conference bridge. 


Note that 3-way conference is possible to an OneOS-based voice-capable router as well as a SIP/H.323 
conference bridge. The OneOS Conference Bridge is a dial-peer voice pots with the attribute 
service voice-bridge. When multiple subscriber call this dial-peer, the calls are accepted and the 
voice signals are mixed (up to max-cal1 are accepted). To configure an OneOS Conference Bridge: 





c 


I (configure) > dial-peer voice pots <x> 

I (pots) > pots-group <y> 

I(pots)> service voice-bridge <max-call> 
I(pots)> no shutdown 

I(pots)> exit 

I (configure) > voice-routing 

I (voice-route)> route <route> 

I(voice-route)> prefix <conf-bridge-number> length <len> 
I(conf-voice-route) > dial-peer pots-group <y> 
I (conf-voice-route)> exit 

I (voice-route)> exit 





gegegggeegas 


The next command under SIP-gateway forces to send a BYE when receiving a ‘202 Accept’ response to 
initiated call transfer (with REFER method). Default: enable. 


CLI (configure)> sip-gateway 
CLI(sipgw)> [no] bye-on-refer-accept 





As of V3.7R10, the command softswitch-profile is deprecated and overridden by the above 
command. 
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4.2.8.2.2_ | Using FXS Voice Features 
4.2.8.2.2.1 Call Waiting 


An FXS subscriber has got one call in progress. When a second call destined to that subscriber comes in, 
the FXS subscriber hears a call waiting tone and the caller hears the phone ringing. The FXS subscriber 
may decide to put the active call on-hold (therefore the remote party placed on-hold hears the music-on- 
hold) and to accept the second call. 


Call Waiting: Putting Active Call on-Hold and Accepting Second Call 





Actions / Events on Phone | Comments 


7\000 One call is active. 


“Beep” The call waiting tone is played. 


R | 2 | Press hook flash button (R) followed by 2. 


You are connected with second caller. 























4.2.8.2.2.2 Second Call 


When a call is active, it is possible to put this call on hold, and then to call a second subscriber. 


Making a Second Call 








Actions / Events on Phone | Comments 





7\000 One call is active. 








R | Press hook flash button. 
444 
a3 A dialing tone is played. Dial the phone number of another subscriber. 











OneOS attempts to connect the call with the new subscriber. 


4.2.8.2.2.3 Releasing Second Call 


When a call is active and one on-hold, you can release the currently active call and switch to the other one. 


Releasing Second Call 








Actions / Events on Phone | Comments 





7\000 One call is active, one is on-hold. 





R | 1 | Press hook flash button followed by 1. 





You are now connected with the remote party that was on-hold. The remote 
that was previously active is now disconnected. 














4.2.8.2.2.4 Brokering 


Brokering is a feature related to an FXS subscriber having two SIP call legs. It refers to the action of 
switching between calls, i.e. putting one call on-hold and retrieving the other call (that was on-hold). The 
party on-hold hears the music-on-hold. 


Brokering 
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Actions / Events on Phone 


Comments 





a Qa 
900 000 
900 000 
000 (@) oO (eo) 000 


Two calls are connected (one active, one on-hold). 





#2) 


Press hook flash button followed by 2. 





You are now in communication with the party previously on-hold. The 
formerly active party is now on-hold. 








Attended Call Transfer 


Attended call transfer is also called call transfer with consultation. 


A subscriber A is an FXS subscriber. Subscriber A is in conversation with subscriber B. Subscriber A puts 
subscriber B on hold. Subscriber A calls subscriber C. Subscriber A asks subscriber C if he wants to talk to 
subscriber B. Then, subscriber A initiates a call Transfer, so that subscriber B talks to subscriber C and the 
calls from subscriber A to subscriber B or subscriber C are released. 


Attended Call Transfer 





Actions / Events on Phone 


Comments 





7 NN 7? NN 
00 000 
900 000 
000 000 


One call is active. 





a 


Press hook flash button. 





444 

444 

aa 
= 


A dialing tone is played. Dial the phone number of another subscriber. 


The new subscriber hangs up the phone. 








Fr 





Hook-on, the call is transferred. 


Note: depending of settings, the transfer can also be done with R4 instead of 
on-hook. 





4.2.8.2.2.6 


Three-Way Conference 


When an FXS subscriber has got two calls (one active, one on-hold) the FXS subscriber may decide to 
start a three-way conference. Three-way conference is started by pressing hook flash and 3. 


Making a Second Call and Starting 3-Way Conference 





Actions / Events on Phone 


Comments 





7 NN 7? oN 
900 000 
900 900 
000 000 


One call is active. 





RJ 


Press hook flash button. 








eS 
| A dialing tone is played. Dial the phone number of another subscriber. 
| 
Tay ) OneOS attempts to connect the call with the new subscriber. The other 
ring! subscriber's phone rings. 





Y, N ip NI 
900 000 
900 000 
888 NOOO (28 


The new subscriber answers. 





£3) 


Press hook flash, then 3. 











3-way conference is started. 
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4.2.9 VoIP Coder Profiles 


It is possible to define a list of coders for the terminal capabilities. The list contains the preference order, in 
which the codec shall be used when negotiating the codec with the remote VoIP endpoint. 


Commands: 
CLI (configure) > voip-coder-profile 1 
CLI (voip-coder)> codec 1 g726r32 30 
CLI (voip-coder)> codec 2 g729ab 10 
Parameters: 
CLI (voip-coder) > codec <preference-index> <codec> [<sample-time-length>] 
[rtp-dynamic <96-127>] 
e preference index: indicates the position in the list of coders (1 to 10). 
e codec: may be g729ab, g711a, g711u, g726r32. 


e sample-time-length: period of frames transmission (in ms). Allowed values are: 


e g729ab: 10, 20, 30, 40. Default: 20. If G.729ab is configured and SIP is the VOIP protocol, 
the codec in SDP indicates G.729 (rtpmap=18 (G729), whereas the media is G729ab 
or G729a, which are compatible codecs). 


e g7lla, g711u: 10, 20, 30, 40. Default: 20. 
e = g726r32: 10, 20, 30, 40. Default: 20. 


e rtp-dynamic <96..127>: relevant for SIP only. Allows defining dynamic payload types. 
Some checks with other payload types configured for DTMF and UDI64K are done. If the rtp- 
dynamic option is absent, the standard payload type values are used. 


Note: G723.1 is not available in the standard OneOS software. 


The selected coder will be the first one in the list matching with the remote capabilities. 


4.2.10 Voice over IP Dial Peer 


The VoIP port is defined as a 'Voice over IP Dial Peer’, that identifies the remote H.323/SIP devices which 
can enter in communication with the OneOS-based voice-capable router. 


Voice over IP dial peers must be created to define all the parameters related to the remote H.323/SIP 
devices. 


For outbound calls, the peer is selected in the routing table. A single peer can be defined for several 
remote devices when using a H.323 Gatekeeper or a SIP proxy. 


For inbound calls, the OneOS-based voice-capable router tries to identify the caller using its IP source 
address (compared with the IP address configured in the dial-peer VoIP). If it is not found, the parameters 
specified in the first configured dial-peer are used. 


To create a dial-peer VoIP, enter: 


CLI (configure)> dial-peer voice voip <index 0-7> 
CLI (voip) > 





One can create several VoIP dial peers; therefore, an arbitrary number (index) identifies each dial peer. 


4.2.10.1 Parameters 
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4.2.10.1.1| Common Parameters 


Use the following command to define the voice coder profile to use with the dial-peer. The profile is 
identified by a number from 0 to 7 (see 4.2.9). Default: 0. When no coder profile is defined, the 
G.711A/20ms coder is used. 


CLI (voip)> voip-coder-profile < 0-7> 


Use the following command to specify the method to be applied for down-speed to G729 in case of 
bandwidth lack. 


CLI (voip)> voice-coder-negotiation {direct | request-—mode|tcsnull|reinvite} 


e direct: Itis the default value. No changeover is done. 


e request-mode: standardized method using the h245 Request-Mode message to force the remote 
peer to switch. 


e tcsnull: standardized method using the h245 capabilities renegotiation with a coder restriction. 


e reinvite: (SIP-specific) the codec change is re-negotiated by sending re-INVITE message. 


Use the following command to enable the silence detection and suppression. Use vad for standard voice 
activity detection. The value vadcng can be used for G.711 and G.726 to enable the comfort noise 
generation (this feature is de-facto enabled if vad is configured with G.729AB). Use the no form to disable 
the voice activity detection. Default: disable. 


CLI(voip)> [no] silence-detection {vad | vadcng} 


Use the following command to specify the DTMF management mode. 
CLI(voip)> [no] dtmf-relay {h245alpha | h245signal | in-band | sip-info | 
in-band-or-sip-info} [forced | depend-of-remote] [<payload-type:96-127>] 
{ [payload-asymmetric | payload-symmetric] } 

e h245alpha: DTMF codes are sent using H.245 in alphanumeric format (default). 

e h245signal: DTMF codes are sent using H.245 signal. 

e in-band: DTMF codes are transmitted in RTP frames (RFC 2833). 

e sip-info: DTMF codes are sent to the remote user agent/proxy/gateway via SIP INFO messages. 

e in-band-or-sip-info: DTMF codes are sent according to the remote capability. 


e forced: DTMF codes are sent to remote and do not take into account the remote capabilities (only 
with in-band mode). 





e depend-of-remote: DTMF codes are sent by default to the remote only if the remote peer indicates 
in SDP if it can receive DTMF (SDP line containing fmtp string). 


e <payload-type:96-127>: the payload type for DTMF can be specified (default 101). 


e payload-asymmetric: the DTMF is sent to remote according to the remote capacities, and the 
DTMF is received according to the programming. 


e payload-symmetric: the DTMF is sent to remote and received according to the first offer (remote 
capacities or programming). 


Use the no form to suppress the DTMF management. 


Use the following command to specify the method to be applied for up-speed to G711 in case of Modem & 
FAX detection. 


CLI (voip)> passthrough-mode {direct | request-mode | tcsnull | reinvite} 
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e direct: proprietary method, which consists in switching directly to G711 the RTP flow without any 
h245 signaling process (specific NSE RTP packets are sent before switching). It is the default value. 


e request-mode: standardized method using the h245 Request-Mode message to force the remote 
peer to switch to G711. 


e  tcsnull1: standardized method using the h245 capabilities renegotiation with a restriction to G711. 


e reinvite: (SIP-specific) the codec change is re-negotiated by sending re-INVITE message. 


Use the following command to specify the fax management mode. 
CLI(voip)> [no] fax-relay {passthrough | t38 | t38o0rpassthrough | t38nse} 
[priority {t38 | passthrough}] 


e passthrough: in this mode the media is forced to G711 (codec up-speed mode). 
e  t38:in this mode the media is forced to T.38. 


e t38orpassthrough: in this mode T.38 and modem pass-through as possible media capabilities. If 
the remote gateway does not support T.38, the capabilities are negotiated such that modem pass- 
trough is used instead of T.38. 


e t38nse: in this mode the media is switched to T.38 by sending a set of RTP frames called NSE 
(Named Service Event). This mode is not standard compliant, but enables interoperability with Cisco 
gateways when a similar mode is configured on Cisco gateways. 


e priority: if the remote gateway supports T.38 and G.711 pass-through, then the priority parameter 
defines the mode to apply (default priority: t 38). 


Use the no form to suppress the fax management. 


Use the following command to specify the G3 FAX detection criterion. 
CLI (voip)> detection-fax {flagv21 | CED} 


e flagVv21: in this mode the FAX is detected when the V.21 flags are received. This mode is more 
reliable but may increase, in some cases, the connection time (default). 


e CED: in this mode the FAX is detected as soon as a CED tone is detected. It should not be configured 
in CED mode if low speed modems are used (Such a modem sends also CED tones and will be then 
interpreted as a fax call instead of a modem call). 





Use the following command to specify the number of T.38 frames added for redundancy. Default: 0. 
CLI (voip)> t38-redundancy <0-4> 


Note that adding frames for redundancy can increase a lot (up to 5 times) the needed bitrate, especially for 
high rate modulations. Provision has been taken, according to the following table, to avoid such drawback. 




















t38-redundancy | V.21 | V.272400 | V.27 4800 | V29.7200 | V.299600 | V.1712000 | V.17 14400 
0 3 0 0 0 0 0 0 
1 4 2 1 1 1 1 1 
2 4 4 3 2 2 2 2 
3 4 4 4 3 3 3 3 
4 4 4 4 4 4 3 3 
































Use the following command to enable or disable the ECM (Error Correction Mode). The ECM divides fax 
pages in HDLC frames so that transmission errors are detected by means of a CRC check. When the 
remote fax receives a full page, it identifies frames with wrong CRC and requests the sending fax to 
retransmit these frames. The process is repeated until all frames are received without CRC errors. In case 
of a noisy fax reception (i.e. with CRC errors), the ECM enables a high quality fax transmission. 


CLI (voip)> t38-ecm {enabled | disabled} 
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enabled is the default value. As ECM was not supported in former OneOS versions, in case of fax 
transmission problems when upgrading to a newer version, it can be interesting to compare results with 
disabled ECM. 


Use the following command to limit the rate of the fax-relay. When the rate is 7200 bps the first training at 
9600 bps is corrupted to force a fallback to 7200 bps. Default: 9600. It means that 14.4 kops V.17 fax will 
connect at 9.6 kbps by default. To allow V.17 fax, use ‘t38-rate 14400’. 


CLI (voip)> t38-rate {4800 | 7200 | 9600 | 14400} 


Use the following command to install a timer (in seconds) in order to avoid the switch in T.38 mode when 
detecting a fax-modem tone. In that case, the detection is done only during the time defined by the timer. 
This feature can be enabled if some wrong fax detections are observed during voice calls. Use the no form 
to remove the timer (default). 


CLI(voip)> [no] timer-max-detection {1..120} 


Use the following command to enable or disable the fallback of Fax Super G.3 to Fax G.3 when the pass 
through mode is not allowed in order to send the fax with T.38 protocol. When enable the tone “ANSam” of 
the fax Super G.3 is replaced by a command T.38 CED of a G.3 fax. If the voice codec is G.711 or the 
T.38 mode not negotiated, the function is disabled. disable is the default value. 


CLI (voip)> sg3tog3 {enable | disable} [<timer:100-3000ms>] 
<timer:100-3000ms> is a configurable timer that defines the maximum time allowed to receive the CNG 


tone (from the calling FAX) at the beginning of the call. It avoids wrong detections and voice cuts due to 
ANSam tone suppression during the call (given in ms in 100ms steps; default value: 1000 = 1 sec). 


Use the following command to enable the automatic modem detection. Use the no form to disable the 
modem detection. The method used for up-speed G711 is defined by the passthrough-mode command. 


CLI (voip)> [no] modem-passthrough 


Use the following command to switch automatically to G.711 if the received flow switches to G.711. This 
parameter must be set to “enable” if the remote device switches directly to G.711 without sending NSE 
RTP packets before. Default: disable. 


CLI (voip)> passthrough-symetric {enable | disable} 


Use the following command to specify the codec to be used in modem/fax pass through mode (up-speed 
to G711). Default: G711a. 


CLI (voip)> passthrough-codec {g71lla | g711u} 


Use the following command to specify the jitter max value for voice (in ms). Default: 100ms. 
CLI(voip)> [no] jitter <20..1000> 


Use the following command to eventually specify a different jitter max value for fax (in ms). Default: 100ms. 
CLI (voip)> fax-jitter <20..1000> 


Use the following command to enable the implicit routing. All the incoming calls are routed to the specified 
pots group whatever the destination number. Use the no form to disable the implicit routing. 


CLI (voip)> [no] implicit-routing pots-group <identifier> 
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Use the following command to limit the number of active call sessions with the defined destination. 
Warning: in case of local call between two ISDN/FXS ports and if the call is managed by a VoIP dial-peer, 
such call accounts for 2 sessions. Default: 30. 


CLI (voip)> max-conn <number> 


Use the following command to enable RTCP-XR frames for MOS calculation. Default: disable. 


CLI (voip)> [no] rtcp-xr 


Use the following command to select the signaling protocol to use. Default: h323. 


CLI (voip)> sig-protocol {h323 | sip | mgcp} 


VoIP dial-peers may be grouped as in a voip-group in an analog way as pots-group. Several VoIP dial- 
peers are member of a voip-group if they have the same voip-group number. Then, it becomes 
possible to route calls to a voip-group. OneOS voice-routing distributes the call over the various dial- 
peers that are member of the group. To configure the voip-group: 


CLI (voip)> [no] voip-group <id:0-30> [priority <0-30>] 


VoIP dial-peers may be grouped in a voice group. A voice group can contain POTS and VoIP ports. To 
configure the voice-group: 


CLI(voip)> [no] voice-group <id:0-30> [priority <0-30>] 


Use the following command to define the default priority of the port in the group (if not defined in the 
voip-group Of voice-group command). In the group all the interfaces with the same priority are 
selected circularly (round robin) or according to the load (load balancing). Default: 0. 


CLI (voip)> priority <0..30> 


To disable the dial peer voice VoIP, use the following command. Use no shutdown to re-enable the dial 
peer voice VoIP (default). 


CLI (voip)> [no] shutdown 


4.2.10.1.2 SIP-Specific Parameters 


Use the following command to tell that the peer is a SIP user agent (server or proxy). 


CLI (voip)> sig-protocol sip 


Use the following command to link the dial-peer VoIP to the SIP server. See 5.2.2 for more details. Use the 
no form to remove the link. 


CLI (voip)> sip-ua {ip-dynamic [restricted | open] | ip-static <A.B.C.D> 
| mac-static <aa:bb:cc:dd:ee:ff>} 


CLI (voip)> no sip-ua 


Use the following command to specify the gateway address (syntax: A.B.C.D:<port> or 
host:<port>). It must be specified if a SIP proxy is not configured under the sip-gateway. It is optional if 
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a proxy is already declared and it overrides the default proxy configured under sip-gateway. The optional 
via parameters specifies an outbound proxy for all the signaling messages. Use the no form to remove the 
gateway. 


CLI (voip)> gw-ip-address <IP-address>[:<port>] [via <IP-address>] 


CLI (voip)> no gw-ip-address 


Use the following command to allow sending and processing SDP information in 180 Ringing messages. It 
makes it possible to send and/or receive ringback tones through the RTP flow. Send AND receive is the 
default value. Please refer to 4.1.4.8 for more details. Use the no form to disallow. 


CLI (voip)> sip-sdp-on-alert [send-receive | receive-only | send-only] 





CLI (voip)> no sip-sdp-on-alert 


When sip-sdp-on-alert is configured, the ringback tone is played immediately from the received RTP 
flow. It might happen that the RTP stream does come immediately after that the in-band IE is sent on the 
ISDN interface. When rtp-inband-notification is present, an in-band IE is sent in a message from 
VoIP to pots only when a first RTP packet is received. Command syntax: 


CLI (voip)> rtp-inband-notification 





CLI (voip)> no rtp-inband-notification 


Use the following command for SIP proxies requiring PRACK messages. PRACK messages are sent by 
the OneOS-based voice-capable router when provisional answers (trying, ringing, etc...) are received. 


CLI(voip)> [no] force-prack 


Use the following command to define how the codec is chosen when receiving a call. If local (default 
value): the selected codec is the first local codec that is the same as one of the remote codec(s). If remote: 
the selected codec is the first remote codec that is the same as one of the local codec(s). 


CLI (voip)> coder-selection-priority {remote | local} 


Use the following command to send RTP silence frames instead of none in order to maintain NAT sessions 
(Hosted Nat Transversal) when a call is typically in hold state with valid SDP IP address. Use the no form 
to stop sending RTP silence frames. 


CLI(voip)> [no] rtp-permanent 


Use the following command to force SIP FROM information element (IE) contained into message when 
this information (calling number) is not present even after voice-routing mechanism is achieved. 


If the calling number is empty and sip-default-from is present, FROM IE is set with sip-default- 
from parameter. If the calling number is empty and sip-default-from is absent, FROM IE is set with 
sip-gateway.sip-username Or sip-server.sip-—username parameter, depending on the direction 
of the call. 





CLI(voip)> [no] sip-default-from <string up to 50 char> 


Use the following command to force the SIP privacy header to the chosen value (for SIP outgoing calls 
only). Possible values are user (RFC3323) or id default value (RFC3325). 


CLI (voip)> sip-privacy-header { user | id } 
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4.2.10.1.3  H.323-Specific Parameters 


Use the following command to tell that the signaling protocol is H.323. 


CLI (voip)> sig-protocol h323 


Use the following command to define if a gatekeeper must be registered and available to establish the call 
(mandatory) or if the routing table routes the calls when there are no gatekeeper available (optional, 
default value). 


CLI (voip)> gatekeeper {optional | mandatory} 


Use the following command to specify the gateway address (syntax: A.B.C.D:<port> or 
host:<port>). It must be specified if a gatekeeper is not used or is optional, unless the IP address is 
directly configured in the routing table. Use the no form to remove the gateway. 


CLI (voip)> gw-ip-address <IP-address>[:<port>] 


Use the following command to enable the H.323 fast-connect mode. If start-h245 is configured, the 
OneOS-based voice-capable router will send a Facility message with a "start H245" command upon an 
incoming call, if capabilities requiring H245 are enabled (T38 FAX, DTMF out of band, and Analog 
interface for hook flash). If no-t38 is configured, T38 will be removed from the Facility message. Default: 
fast-connect (equivalent to fast-connect no-start-h245 t38). Use the no form to disable fast- 
connect mode. 


CLI (voip)> fast-connect [start—-h245 | no-start—-h245] [no-t38 | t38] 





CLI(voip)> no fast-connect 


Use the following command to enable the h245 tunneling mode. Default: disable. 
CLI (voip)> [no] h245-tunnel 


Use the following command to enable a mode where any failure on the media channel opening has no 
effect on the call signaling. If enable, a call can remain established without any RTP flow (no voice). In this 
case, the call must be disconnected by the users. Default: disable. 


CLI(voip)> [no] call-—media-independent 


Use the following command to insert a PROGRESS Information Element “Inband information” in Alert 
message coming from the H.323 remote end. It enables the process of the received RTP flow for the call 
back tone. Default: disable. 


CLI(voip)> [no] force-rec-inband 


Use the following command to insert a PROGRESS Information element “Inband information” in Alert 
message sent to the H.323 remote end. It may be necessary to ask the remote end to take into account 
the RTP flow sent before connection (ringback tone, for example). Default: disable. 


CLI (voip)> [no] force-tx-inband 


Use the following command to specify the coding rule used for the information element containing the 
Advice of Charge (AOC) information. Default: ETSI. 


CLI(voip)> [no] aoc-format {etsi | ecma} 
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4.2.11 Voice over IP Routing Table 
4.2.11.1 Introduction 


Voice call routing is a key element to apply modifications on received calls and is intended for several 
purposes: 


e Simple call routing when no gatekeeper is declared. 
e Insertion and suppression of prefixes/suffixes in the called/calling numbers. 


e Force the use of some types of codec/bearer capabilities for some applications where fax/modem 
transport over IP is required, flexibility is required to achieve interoperability with gateways having 
fewer features. 


e Voice call backup in case of network failure. 


Incoming calls are matches against a list of number patterns; if the called number matches a pattern, then 
the configured transformations and routing are applied. 


The following sections will focus on a more detailed description of routing. 
4.2.11.2 Numbering plan management 


In order to make the routing table as simple as possible — routing the calls without handling the numbering 
plan prefixes (national, international, country code) — OneOS provides functions to describe the numbering 
plan and to process the numbers with regard to that numbering plan before (pre-processing) and after 
(post-processing) the routing process. 


Refer to 4.2.11.5 for more information. 
4.2.11.3 Wildcards 


First to achieve number matching against a prefix, you might need to define wildcards. 


Wildcard "any number": It is referenced as the dot character ".". When you write a prefix with this wild card, 
the dot represents any number of any lengths. In the following example: "10." stands for 10...... 


Wildcard "any digit": It is referenced as the X character "X". When you write a prefix with this wild card, the 
X represents any digit character. In the following example: "10X" stands for 100 to 109, 10* and 10#. 


Wildcards "digit subset": They are referenced as a letter such as "A", "B", "C" ... (except "X"). When you 
write a prefix with such wild card, the letter represents any of the configured digits. In the following 
example: "wildcard C 01234" the letter C stands for 0 or 1 or 2 or 3 or 4. 


Refer to 4.2.11.5 for more information. 


4.2.11.4 Routing process summary 
4.2.11.4.1 Case of a call coming from a local port 


The routing has the following general structure: 
Incoming call routing and transformation > Translation > Routing > Outgoing routing 
1. The calling number translation defined in the dial-peer voice pots is applied. 


2. The routing table is checked against the incoming routing rules (with prefix-type = incoming or in- 
and-out) according to the configured number type (calling or called) and with the dial-peer = pots- 
group corresponding to the local port. 


3. If a match is found, translations on calling and/or called numbers are applied. If reject is 
configured, the call is cleared. If next is configured, the routing table is checked again from the 
specified rule with the translated numbers. If a match is found, translations on calling & called 
numbers are applied again. This process is applied until the end of the table or until a Last option 
is encountered. This process enables several number translations. 


4. The implicit-routing parameter of the dial-peer pots is checked. If defined, the call is directly routed 
to the corresponding VoIP peer (dial-peer VoIP) or local port (dial-peer POTS). The routing process 
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is completed. 


5. The routing table is checked (from the first rule) against the outgoing rules (prefix-type = outgoing 
or in-and-out) according to the number type (calling or called). 


6. Upon a total match, translations on calling and/or called numbers are applied and the call is routed 
to the dial-peer VoIP port. The routing process is finished. It will be restarted from this step in case 
of backup (and go to step 5 from the following routing rule). 


7. Upon a partial match (in case of overlap dialing only), the routing is considered inconclusive but the 
second end-of-dialing timer is started. The routing process will be done again with the following digit 
or upon the second end-of-dialing timer expiry. 


8. If no match, the call is cleared. 


4.2.11.4.2 Case of a call coming from the H.323/SIP Network 


1. The routing table is checked against the incoming routing rules (with prefix-type = incoming or in- 
and-out) according to the configured number type (calling or called) and with the dial-peer = VoIP. 
In this step, the dial-per VoIP identifier is unknown. 


2. Upon a match, the dial-peer VoIP identifier is taken into account to determine for example a voice 
coding profile. Translations on calling and/or called numbers are applied. If reject is configured, 
the call is cleared. If next is configured, the routing table is checked again from the specified rule 
with the translated numbers. Upon a match, translations on calling & called numbers are applied 
again. This process is applied until the end of the table or until a Last option is encountered. Then 
go directly to step 4. 


3. If no match, the source IP address is compared to the address configured in all the dial-peer VoIP. 
In case of match, the corresponding dial-peer VoIP is selected. If not, the lowest dial-peer VoIP 
identifier is selected by default. 


4. The implicit-routing parameter of the selected dial-peer VoIP is checked. If defined, the call is 
directly routed to the corresponding pots-group. The routing process is finished. 


5. The routing table is checked (from the first rule) against the outgoing rules (prefix-type = outgoing 
or in-and-out) according to the number type (calling or called) and with dial-peer = pots-group. 


6. Upon a total match, translations on calling and/or called numbers are applied and the call is routed 
to the dial-peer pots-group. The routing process is finished. It will be restarted from this step in case 
of backup (and go to step 5 from the following routing rule). 


7. Upon a partial match (in case of overlap dialing only), the routing is considered inconclusive and the 
second end-of-dialing timer is started. All the routing process will be done again with the fully 
received number when the following digit will be received or when the second end-of-dialing timer 
will elapse. 


8. If no match, the call is cleared. 


4.2.11.4.3 Total & Partial match 


A partial match is tested only in case of destination number received in overlap mode. It occurs when the 
number to be tested is included in the configured prefix. A total match occurs when the configured prefix 
with the specified length (or upon a timer expiry) is included or equal to the number to be tested. 


Example of partial & total match: 


























Number Type Prefix Length Match 
1000 10 2 No 
1000 10. 2 Total 
1000 Overlap 10. 8 Partial 
1000 En-Bloc 10. 8 No 

10 Overlap 1000 4 Partial 
10 En-Bloc 1000 4 No 
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empty Overlap all values >0 Partial 
empty Overlap Total 
1000 En-Bloc Total 








4.2.11.4.4 Routing Empty Number 


Sometimes, it may be necessary to specify a routing rule for an empty number (SETUP message in 
overlap mode received on an ISDN interface, off-hook event on an analog interface). For that case, a 
particular syntax is defined: "=". The length is equal to 0 and in case of outgoing routing process, the match 
is considered total (the outgoing routing process is finished). 


4.2.11.5 Configuration 


Global call distribution mode 


Use the following commands in global voice configuration mode to define how calls are distributed within a 
group among ports with the same priority (default: round robin). 


CLI (configure> voice-global 

CLI (voice-global)> call-distribution { round-robin | load-balancing } 
CLI (voice-global)> exit 

CLI (configure> 





Numbering plan management 


Use the following commands in global voice configuration mode to configure the numbering plan so as 
OneOS is able to manage the numbering plan (default: no num-plan-management). 





CLI (configure> voice-global 

CLI (voice-global)> [no] num-plan-management 
CLI (num-plan-mgt)> national-prefix <nn> 

CLI (num-plan-mgt)> international-prefix <ii> 
CLI (num-plan-mgt) > country-code <CC> 

CLI (num-plan-mgt)> exit 

CLI (voice-global)> exit 

CLI (configure> 


Use the following command in dial peer voice pots (FXS) or dial peer voice voip (SIP) configuration mode 
to define the default type of number for FXS and SIP before applying the routing process (default: national 
calling-number and unknown called-number). 


CLI (configure)> dial-peer voice pots/voip <n> 
CLI (pots/voip)> default-type-of-—number { unknown | national } { calling- 
number | called-number | all } 


Notes: 


This command can be entered twice (different calling and called type of number). 
This command is of no effect on dial peer voice (ISDN) and dial peer voice voip (H.323). 


The default type of number applied to the calling number is also applied to the number shown in 
the Redirection IE or the SIP diversion header. 


The pre-processing allows having a unique format for the numbers (without prefixes and with the ad-hoc 
type of number) before applying the routing process. Use the following command in dial peer voice pots 
(FXS) or dial peer voice voip (SIP) configuration mode to apply the pre-processing on the calling or/and the 
called numbers (default: all). 


CLI (pots/voip)> numplan-preprocessing { none | calling-number 
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| called-number | all } 
Notes: 


- This command is of no effect (out accepted and saved) if no num-plan-management is in force. 


- The pre-processing is also applied to a transferred or rerouted number (if called-number or all 
apply). 


- The pre-processing is also applied to the number shown in the Redirection IE or the SIP 
diversion header (if calling-number or all apply). 


The post-processing allows defining the format of the numbers after having applied the routing process). 


Use the following command in dial peer voice pots (FXS) or dial peer voice voip (SIP) configuration mode 
to define the format of the international numbers (default: supported all). 


CLI (pots/voip)> international-numplan {not-supported |supported | forced} 
{ calling-number | called-number | all } 
With supported: an international number is sent in ISDN with the type of number international and in SIP 
with the prefix +. 


With not supported an international number is sent with the international prefix (see num-plan- 
management) and the type of number unknown. This is the preferred value especially for FXS. 


With forced all numbers, including national numbers, are sent as international numbers. 

Notes: 
- This command can be entered twice (different management for calling and called numbers). 
- | This command is of no effect (but accepted and saved) if no num-plan-management is in force. 
- This command also applies to a transferred or rerouted number (if called-number or all apply). 


- This command also applies to the number shown in the Redirection IE or the SIP diversion 
header (if calling-number or all apply). 


Use the following command in dial peer voice pots (FXS) or dial peer voice voip (SIP) configuration mode 
to define the format of the national numbers (default: supported all). 


CLI (pots/voip)> national-numplan { not-supported | supported } 
{ calling-number | called-number | all } 
With supported no specific process is done. 


With not supported a national number is sent with the national prefix (see num-plan-management) and 
the type of number unknown. This is the preferred value especially for FXS and SIP. 


Notes: 
- This command is of no effect (but accepted and saved) if no num-plan-management is in force. 
- This command also applies to a transferred or rerouted number (if called-number or all apply). 


- This command also applies to the number shown in the Redirection IE or the SIP diversion 
header (if calling-number or all apply). 


Routing table commands and parameters 


The routing table is configurable with the following command. 


CLI (configure) > voice-routing 
CLI (voice-route) > 
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Use the following command to display all the configured routing rules. 


CLI (voice-route)> display 


Use the following command to enter in the configuration mode for a routing rule (index from 1 to 100). 


CLI (voice-route)> route <index> 


Use the no form to delete the routing rule. 


CLI (voice-route)> no route <index> 


Use the following command to insert a routing rule in the list. 





CLI (voice-route)> insert <index> 


To enter into the routing rule #1 configuration: 


CLI (voice-route)> route 1 
CLI (conf-voice-route) > 

or 

CLI (voice-route)> insert 1 
CLI (conf-voice-route) > 


The order of the routing rules in the list is significant: the routing process scans the table from the first to 
the last rule until a match is found. 


Route Configuration 


Use the following command to specify, for a wildcard "digit subset", a list of authorized digits. Example: 
wildcard C 01234. Up to two partial wildcards can be configured. Default: only the letter x is configured 
for 0-9, #,* (and cannot be modified). This wildcard configuration is specific to the routing rules and is 
used only for the 'prefix' command (NOT for the 'translate' command). 


CLI (conf-voice-route)> wildcard <A-Z a-z> <List of digits 0-9,#,*> 


Use the no form to remove the wildcard. 


CLI (conf-voice-route)> no wildcard 


Use the following command to define a matching prefix. The phone digits (0 to 9, #, *), the wildcards digit 
subset (when configured), the wildcard any digit ("X"), the wildcard any number (".") and the empty number 
"=" can be used. The timer parameter must be used with certain ISDN phones sending the called number 
in the Keypad ISDN IE. 


CLI (conf-voice-route)> prefix <pattern> [to <last-number>] [number-type 
<type>] [number-presentation <presentation>] [length <0-35>] [timer | 
timer-or-#] [overlap] 


e to <last-number>: if this optional parameter is present, the number is matched if it is in the range 
<pattern> and <last-number>. Therefore, pattern must be a number (i.e. with no wild card). 


e number-type {all | unknown | national | international | network | 
subscriber | abbreviate}: specifies the type of number (see ITU-T Q.931) to be checked; all 
(default value) means "any type of number". 


° number-presentation {all-presentation | allowed | restricted | number- 
unavailable}: specifies the type of presentation of the calling number (see ITU-T Q.931) to be 
checked; all-presentation (default value) means "any type of calling number presentation". 


e length <0-35>: specifies the minimum number of digits to receive before sending the call. Must be 
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greater or equal to the prefix length. Default: equal to prefix length. 


e timer: enables the timer mode to complete the dialing phase. It must be disabled if a length is 
specified. Default: disable. 


e timer-or-#: with this parameter, the number is considered complete if the inter-digit timer elapses 
(same as timer parameter) or if the entered digit is #. The # digit is not considered a dialing digit: if 
the user calls 30034567#, the called number is 30034567. 


e overlap: if enable, the call is sent without the Information Element "Sending Complete", enabling the 
possibility of overlap dialing. (Significant only for calls coming from an analog local port). Default: 
disable. 


Use the no form to remove the prefix definition. 


CLI (conf-voice-route)> no prefix 


Use the following command to define an alternate matching prefix. It makes it possible to have two 
matching entries for a single route. 


CLI (conf-voice-route)> alt-prefix <prefix> [number-type <type>] [length 
<0-35>] [timer | timer-or-#] [overlap] 
Use the no form to remove the alternate prefix definition. 


CLI (conf-voice-route)> no alt-prefix 


For example, the match of private and public numbering plan: 


route 14 
dial-peer pots-group 4 
! match public number 
prefix 0141871004 length 10 
! match private number 
alt-prefix 8004 length 4 
prefix-type outgoing called last 
! translate private number into public number 
translate ABCD 014187ABCD called 
loopback-routing 
exit 


Use the following command to specify if the prefix must be checked for the incoming routing process or the 
outgoing routing process or both, and which number must be checked (calling or called). 


CLI (conf-voice-route)> prefix-type {incoming | outgoing | mixed} {called 
| calling} {last | next | reject | backup} [<bc-type>] 


For the incoming routing process, the next-route parameter specifies if the routing process must check 
another rule (next) or not (last) before starting the outgoing routing process or reject the call. 


For the outgoing routing process, the next-route parameter specifies if a following backup routing rule 
must be used in case of outgoing call failure or if the call must be rejected (reject). 


The bc-type is the bearer capability type. The call is processed through this route if the bc-type of the 
received call matches the bearer capability. The bc-t ype values are: 


e full: any bearer capability (default). 

e voice: ISDN voice bearer capability. 

e data: data bearer capability (ISDN BC= UDI64k or transparent codec -RFC4040-). 
e 3k1: ISDN 3.1 kHz bearer capability. 

e voice-3k1: voice 3.1 KHz. 

Default: outgoing, called, last, and full (any bc type). 


Use the no form to remove the prefix type definition. 
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CLI (conf-voice-route)> no prefix-type 


Use one of the following commands to specify the type of destination. 


CLI (conf-voice-route)> dial-peer pots-group <identifier> [{ua-sip | alias 
| gw-prefix}] [hunting] 


Q 


LI (conf-voice-route)> dial-peer voip <identifier> [{ua-sip | ip-address 
<ip-address> | mac-address <mac-address>}] 


CLI (conf-voice-route) > dial-peer voip-group <identifier> 





CLI (conf-voice-route)> dial-peer voice-group <identifier> 


e identifier: local port group if pots—group is selected, dial-peer VoIP index if voip is selected. 


e ua-sip (SIP specific): This command allows configuring the various SIP accounts for phone 
numbers. The registrar address must be defined under the SIP gateway configuration mode. By 
default, the phone number provided as the route prefix (See prefix command) to this dial-peer is 
registered. An optional sip identifier (sip-username) and sip username & password (sip- 
authentication) can be specified (see bellow) to override default settings. WARNING: if several 
routes must be configured for the same dial-peer, the route containing the ua—sip option must 
be the first one in the voice-routing table. 


e alias | gw-prefix (H.323 specific): the specified prefix or number is used as a H.323/SIP alias or 
H.323/SIP gateway identifier for registration to a gatekeeper. Optional and authorized only if pots- 
group is specified. 


e hunting: this option enables the hunting mode. Only valid for a pots-group. 


e ip-address (syntax: A.B.C.D:<port> orhost:<port>): remote IP address (for VoIP type only) 
if it is not configured in the dial-peer VoIP (without a gatekeeper/SIP proxy). 


e mac-address (syntax: aa:bb:cc:dd:ee:ff): remote MAC address (for VoIP type only) if it is not 
configured in the dial-peer VoIP. 


Use the no form to remove the dial-peer. 


CLI (conf-voice-route) > no dial-peer 


Use the following command to specify the sip identifier (optional parameter). 
CLI (conf-voice-route)> [no] sip-username <string 0-35> 
For a dial-peer pots-group: to specify the sip identifier used for the "From" & "Contact" header field of the 


registration and INVITE methods (the ua-sip option must be enabled). If sip-username is empty (default 
value), the prefix (phone number) is used. 


For a dial-peer VoIP: to specify a sip identifier used for the "To" field. It is used to replace the destination 
phone number by a name. 


Use the no form to remove the sip username (default). 


CLI (conf-voice-route)> no sip—-username 


Use the following command to specify the sip username and password for authentication in the registration 
and INVITE procedure (the ua—sip option must be enabled) (optional parameter). 


CLI (conf-voice-route) > sip-authentication <username 1-15> <password 1-15> 
Use the no form to remove the sip authentication parameters (default). 
CLI (conf-voice-route)> no sip-authentication 


Use the following command to force the use of a hostname ("From" and "Contact" fields) instead of an IP 
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address or default device hostname (configured in the SIP gateway) in REGISTER (the ua-sip option 
must be enabled) and in INVITE. This parameter obsoletes the previous sip—user parameter. 


CLI (conf-voice-route) > sip-device-host-name <dns-name 1-32> 


Use the no form to remove the sip authentication parameters (default). 


CLI (conf-voice-route)> no sip-device—-host—name 


Use the following command to define authentication (used for SIP server only). See 5.2.3 for more details. 


CLI (conf-voice-route) > sip-uas-authentication <usrname> <password> <type> 


Use the no form to remove the sip server authentication parameters (default). 


CLI (conf-voice-route)> no sip-uas-—authentication 


Use the following command to manage the loopback routing 


The loopback routing is an attribute to allow an inbound call to be routed to the same origin. By default, a 
loopback-routing is allowed on a dial-peer pots-group and disabled in case of VoIP dial-peer. The default 
values correspond to the common case: a call coming from the softswitch (VoIP dial-peer) is not re-routed 
to the softswitch. A call coming from an ISDN line bundle can be re-routed back to the ISDN (for local 
calls). 


CLI (conf-voice-route)> [no] loopback-routing 


Use the following command to specify the number of digits to remove at the beginning of the called or 
calling number (default: called) (optional parameter). 


CLI (conf-voice-route) > suppress-prefix <prefix 0-35> [calling | called] 


Use the no form to remove the prefix suppression (default). 


CLI (conf-voice-route)> no suppress-prefix {calling | called} 


Use the following command to specify the number to be inserted at the head of the called or calling 
number (default: called) (optional parameter). 


CLI (conf-voice-route)> insert-prefix <prefix 0-35> [calling | called] 


Use the no form to remove the prefix insertion (default). 


CLI (conf-voice-route)> no insert-prefix {calling | called} 


Use the following command to specify the number to be inserted at the end of the called or calling number 
(default: called) (optional parameter). 


CLI (conf-voice-route)> insert-suffix <suffix 0-35> [calling | called] 


Use the no form to remove the suffix insertion (default). 


CLI (conf-voice-route)> no insert-suffix {calling | called} 


Use the following command to specify advanced translations on the calling or called number. 


CLI (conf-voice-route)> translate <number-to-translate> <translated- 
number> [calling | called] 


The syntax for the number to translate: "." specifies "any number of any digits", "0-9" specifies digits to be 
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compared, "A-z" identifies "any digit". 


The syntax for the translated number: "0-9" specify fixed digit and "A—z" defines digits specified in the 
"number to translate". 


Example: "translate .345ABC000 10ABC calling" specifies a translation of any calling number 
ending by "345ABC000" to "10ABC" (12345789000 translated to 10789). 


Use the no form to remove the translation (default). 


CLI (conf-voice-route)> no translate {calling | called} 


Use the following command to replace or insert (if absent) a full calling number information element with a 
configurable Q.931 CLIP/CLIR header. 


CLI (conf-voice-route)> insert-calling <number 0-35> [type <type value>] 
[plan <num plan>] [presentation <value>] [screening <value>] 


e type: O=unknown, 1=international, 2=national, 3=network, 4=subscriber, 6=abbreviated. 





e plan: O=unknown, 1=isdn, 3=data, 4=telex, 8=national, 9=private. 

e presentation: O=allowed, 1=restricted, 2=unavailable. 

e screening: O=not-screened, 1=verified-passed, 2=verified-failed, 3=Network 
Default: type=0, plan=0, presentation=0, screening=0. 

Example: insert-calling 456 type 3 plan 1 presentation 0 screening 1 
Use the no form to remove the calling number insertion (default). 


CLI (conf-voice-route)> no insert-calling 


Use the following command to force the calling number header for the Calling Line Identification Restriction 
complementary service. See 4.1.4.6 for permitted values. 


CLI (conf-voice-route)> force-clir <presentation code> <screening code> 


Use the no form to remove the CLIR configuration (default). 


CLI (conf-voice-route)> no force-clir 


Use the following command to force the type of numbering plan for the called or the calling number. See 
ITU-T Q.931 for the values. Example: force-numplan 17 called and ins-prefix 1 adds the 
international prefix for USA (+1). This function is protocol independent. 


CLI (conf-voice-route) > force-numplan <num plan 0-127> {called | calling} 


Use the no form to remove the type of numbering plan configuration (default). 


CLI (conf-voice-route)> no force-numplan 


Use the following command to force the Bearer Capability Information Element to the desired value. (Note: 
uy law - written u law - is used in the USA and Japan). If the destination number is an ISDN data terminal 
(video, fax group 4), you must select unrestricted here and force the voice codec to be G.711A. 


CLI (conf-voice-route) > force-bearer-cap {speech-a | speech-u | 
unrestricted | audio-a | audio-u} 


Use the no form to remove the Bearer Capability configuration (default). 


CLI (conf-voice-route)> no force-bearer-can 


Use the following command to specify the emergency level of the call. The emergency level is updated 


Page 4.2-104 of 166 


ONEOS V4.2R5 VOICE USER GUIDE (EDITION 5) 


only if it is lower than the current value, which is assigned to the call. It can be used for the incoming or the 
outgoing routing process. 


CLI (conf-voice-route) > emergency <1..200> 


Use the no form to set the emergency level to 100 (default). 





CLI (conf-voice-route)> no emergency 


Use the following command to provide a service of device reboot, optionally with a new configuration file, 
for maintenance purpose. This service is enabled only for the incoming routing process. The file name can 
be present in any directory of the file system. It replaces the current configuration file defined in 
bsaBoot.inf. The old configuration file is lost. This functionality enables to reboot the router with a 
default configuration file. 


CLI (conf-voice-route)> startup-file <file name> 


4.2.11.6 Use of the routing table for SIP naming 


The routing table may be used to configure specific SIP username or hostname for a voice port or each 
subscriber. If necessary, routing rules may be defined only for that purpose. 


Registration 


The OneOS-based voice-capable router checks every routing rule including the ua-sip option and 
concerning a local pots-group. For each rule, a REGISTER message is sent with the prefix (optionally 
replaced by the sip-username parameter), the default hostname (optionally replaced by the sip-device- 
host-name parameter). 


Call Signaling: Outgoing Call 


For each new call, the OneOS-based voice-capable router checks in the whole routing table if the calling 
number matches with the prefix number of a rule “outgoing routing and called number” or “incoming routing 
and calling number” concerning the local port where the call comes from. If a match occurs, the "From" 
and "Contact" fields will be built from the optional parameters sip-username and sip-device-host-name 
instead of the calling number and default hostname. Authentication parameters, if configured, may also be 
used. 


The default value of the "To" field is the called phone number. It can be replaced by a name if the rule 
used for the outgoing routing on dial-peer VoIP includes a sip-username parameter. 


Call Signaling: Incoming Call 


If the "To" field is a username (not a phone number), the relevant routing rules (outgoing type, concerning 
local ports only) are checked to find a match with a sip-username. If it is found, the called phone number is 
determined by the prefix. 


For each provisional response, the "From" field and the "To" field are identical respectively to the "From" 
field and the "To" field received in the INVITE message. For the 2000K message, the "Contact" field is 
updated the same way as for the "From" field of the outgoing call (the routing table is checked to find the 
called number). 


Example: defining and registering a sip-username user_1 for subscriber 3001. The subscriber is registered 
and identified as “user_1”. 


route 4 

prefix 3001 

dial-peer pots-group 1 ua-sip 
prefix-type outgoing called 
sip-username user_1 
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exit 


Example: defining a hostname “name1” specific for a voice-port (pots 2) with a dedicated routing rule. 


route 4 

prefix . 

dial-peer pots 2 

prefix-type incoming calling 
sip-device—-host-name namel 
exit 


4.2.11.7 Call Backup Routing Parameters 


Backup Criteria: Q.850 Release Causes 


A call can be routed via a backup route in case of connection failure when the backup option is selected. 
The failure causes (defined in ITU-T Q.850) allowing a call backup to be processed are configurable. Up to 
8 classes of causes are defined in the standard. Each class includes several cause values among 16 
possible, that means 128 causes at maximum. 


Q 


LI (configure) > voice-routing 

LI (voice-route) > backup-cause 

LI (backup-cause)> add {class | value} <value> 

LI (backup-cause)> remove {class | value} <value> 
LI (backup-cause)> exit 





Cl 
Cl 
Cl 
Cl 
By default, all causes belonging to Class 0 and 1 disallow call backup routing and all causes belonging to 


Class 2 to 7 allow call backup routing. 


To add (call backup allowed) or remove (call backup forbidden) a full class use add/remove class 
<0..7>. To add or remove a specific cause use add/remove value <0..127>. 


Use the no form to re-apply the default call backup configuration. 


CLI (voice-route)> no backup-cause 


Note: the configuration is taken into account by the “exit” command. 


Use the following command to display the current call backup configuration (list of causes). 


CLI (backup-cause) > display 


Backup Timers 


A global timer can be configured for backup. It is used when the timeouts on the outbound call-leg are too 
long: it becomes necessary to start the backup process before the timeout on the inbound call-leg expires. 


CLI (configure) > voice-routing 
CLI (voice-route) > backup-timer <duration 5..60sec> 
CLI (voice-route)> exit 


Default: 10 seconds. 


Note: this timer only applies in case of SIP outbound call. 
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4.3 EXAMPLES 


e Rule 1: any number using this format '30xxxx' is routed to the dial-peer voip #1 (IP address 


172.30.40.2), the first four digits are suppressed. 


e Rule 2: the destination number starting by 4001 is routed to the local port group #1 and is used as a 


H.323/SIP alias for registration. 


CLI (configure) > voice-routing 
CLI (voice-route)> route 1 
CLI (conf-voice-route)> prefix 30 length 4 overlap 
CLI (conf-voice-route)> dial-peer voip 1 gw-addr 172 
CLI (conf-voice-route) > supp-prefix 4 

CLI (conf-voice-route)> exit 


CLI (voice-route)> route 2 

CLI (conf-voice-route)> prefix 4001 length 4 
CLI (conf-voice-route) > dial-peer pots-group 1 alias 
CLI (conf-voice-route) > supp-prefix 4 

CLI (conf-voice-route)> exit 


To display the routes: 


CLI (voice-route)> display 

1 - 30 length 4 voip 2 [172.30.40.2] supp 4 
2 - 4001 length 4 pots 1 alias supp 4 

CLI (voice-route) > 


It is possible to test the routing table with the following command: 








CLI (voice-route)> test <called number> <calling 
from-voip} <dial-peer id> 


4.3.1 Configuration Example 


-30.40.2 


number> {from-pots | 


To use these configuration examples, copy & paste the following command lists in a configuration file or to 


the CLI. 


Configuration environment: 4 BRI ports, use of a gatekeeper, registration if a minimum of 4 digits prefix for 


admission request, coder G.729AB and G.711, no fast connect. 


! Physical voice ports declaration 
voice-port 5/0 

exit 

voice-port 5/1 

exit 

voice-port 5/2 

exit 

voice-port 5/3 

exit 


! BRI interface parameters 
interface bri 5/0 

isdn 

application-interface voip 
protocol-emulation isdn-nt 
exit 

exit 


interface bri 5/1 
isdn 
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application-interface voip 
protocol-emulation isdn-nt 
exit 
exit 


interface bri 5/2 

isdn 

application-interface voip 
protocol-emulation isdn-nt 
exit 

exit 


interface bri 5/3 

isdn 

application-interface voip 
protocol-emulation isdn-nt 
exit 

exit 


! local voice ports 


dial-peer voice pots 0 
pots-group 1 

port 5/0 

exit 

dial-peer voice pots 1 
pots-group 1 

port 5/1 

exit 

dial-peer voice pots 2 
pots-group 1 

port 5/2 

exit 

dial-peer voice pots 3 
pots-group 1 

port 5/3 

exit 


! H323 gateway global parameters (gatekeeper) 


h323-gateway 

gw-interface fastethernet 0 
gatekeeper id ZONE1 ipaddr 10.2.2.1 
h323-id GW1 

no shutdown 

exit 


! Voice coder list (terminal capabilities) 


voip-coder-profile 1 
codec 1 g729ab 20 
codec 2 g71lla 20 
exit 


! dial-peer voip: remote voip devices 


dial-peer voice voip 1 
gatekeeper mandatory 

no fast-connect 
voip-coder-profile 1 
silence-detection vad 
implicit-routing pots-group 1 
exit 


! routing table 


voice-routing 
route 1 
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prefix . length 4 
dial-peer voip 1 
exit 
exit 


4.3.2 Authentication example 


Route 1 is used for invite authentication and route 102 for registration authentication. 


voice-routing 
route 1 
dial-peer pots-group 0 
sip-authentication +33320030001@antwerp.ft.com test 
prefix-type incoming calling next 
prefix . timer-or-# 
no loopback-routing 
exit 
route 91 
dial-peer voip 0 
prefix-type outgoing called last 
prefix . timer-or—-# 
no loopback-routing 
exit 
route 102 
dial-peer pots-group 0 ua-sip hunting 
sip-authentication +33320030001@antwerp.ft.com test 
prefix-type outgoing called last 
prefix 31356876052 length 11 
suppress-prefix 2 called 
force-numplan 33 called 
no loopback-routing 
exit 
exit 


4.3.3 Backup example 


Route 2 on ISDN is used as backup when route 1 VoIP is no more available. 


interface bri 5/0 

isdn 

protocol-emulation isdn-nt 
exit 

no shutdown 

execute 
exit 
voice-port 5/0 
clock-source free_run 
exit 
dial-peer voice pots 0 
pots-group 0 

port 5/0 

no shutdown 
exit 
dial-peer voice voip 0 
Sig-protocol sip 
gw-ip-address 192.168.1.2 
voip-coder-profile 0 

no shutdown 


exit 
voice-routing 
route 1 


dial-peer voip 0 


Page 4.3-109 of 166 


ONEOS V4.2R5 VOICE USER GUIDE (EDITION 5) 


prefix-type outgoing called backup 


prefix . timer-or-# 
no loopback-routing 
exit 

route 2 


dial-peer pots-group 0 
prefix-type outgoing called last 


prefix . timer-or-# 
Loopback-routing 

exit 

exit 


sip-gateway 

no calling-number-checking 
gw-interface fastethernet 0 intrusive 
no shutdown 

exit 

voip-—coder-profile 0 

codec 0 g71lla 20 

exit 
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4.4 STATISTICS DISPLAY 


The Command Line Interface provides access to statistics and configuration status for the voice service. 
The show commands can be used at any level in the CLI tree. 


The syntax is the following: 


CLI> show voice <parameters> <index> 


parameters defines the port or the connection 


index specifies the port or connection number; al1 specifies all ports or connections. 


4.4.1 Running Configuration 


The command show voice running-config provides the current voice configuration with a list of CLI 
commands that are the exact differences between the current configuration and the default configuration. 
This command enables easy replication of configuration over other devices. 


This set of commands can be entered in another device to set up the voice service with the same 
parameters. First, it is preferable to use the voice-default CLI command to ensure that the device 
starts with the same default configuration. 


CLI> show voice running-config 
Building configuration... 
voice-default 
voice-port 5/0 

clock-source free_run 

cho-disable modem 
metering 0 
aoc-d-service forced 











aoc service forced 
no led-alarm-report 
exit 


voice-port 5/1 
clock-source free_run 
cho-disable modem 
metering 0 
aoc-d-service forced 











aoc service forced 
no led-alarm-report 
exit 


dial-peer voice pots 0 
pots-group 0 

port 5/0 

no shutdown 

exit 
dial-peer voice pots 1 
pots-group 0 

port 5/1 

no shutdown 
exit 
dial-peer voice voip 0 
call-media-independant 

dtmf-relay in-band 

fax-relay t38o0rpassthrough priority t38 
gatekeeper mandatory 

h245-tunnel 

modem-—passthrough 

passthrough-mode request-—mod 
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voip-coder-profile 0 
aoc-format ecma aoc-e-generation remote 
no shutdown 


exit 
voice-routing 
route 1 


dial-peer pots-group 0 
prefix-type incoming called last 
prefix . length 0 

insert-—prefix #99 called 


loopback-routing 
exit 
route 2 

dial-peer voip 0 


prefix-type outgoing called last 
prefix #993651. length 8 overlap 
suppress-prefix 7 called 


force-clir 11 

no loopback-routing 
exit 
route 3 

dial-peer voip 0 


prefix-type outgoing called last 


prefix #99. length 4 


overlap 


suppress-prefix 3 called 
force-numplan 0 called 


no loopback-routing 
exit 
route 4 

dial-peer voip 0 


prefix-type incoming calling last 


prefix . length 0 


insert-—prefix #98 calling 


no loopback-routing 
exit 
route 5 


dial-peer pots-group 0 hunting 
prefix-type outgoing calling last 


prefix #98. length 3 


suppress-prefix 3 calling 


loopback-routing 
exit 
exit 
h323-gateway 
gw-address autoconfig 
gw-interface bvi 1 





q931-connection-timeout 180 
bandwidth-control ratio 100 rate current-rat 





gw-interface-bw-ctrl 





set-portability enable timeout 4320 


payload-64k-unrestrict 





no shutdown 
exit 
sip-gateway 
shutdown 
exit 
sip-server 
shutdown 
exit 
voip-coder-profile 0 
codec 0 g729ab 20 
codec 1 g7lla 20 
exit 
CLI> 








d 101 
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4.4.2 Voice Hardware and Software versions 


To show the voice hardware configuration enter: 


CLI> show voice hardware full 





Voice module : 6 lines 
otherBoard : 2 BRI 
Ext Module : MF100 
: 4 FXS 


To show the voice software version enter: 


CLI> show voice version 
Voice VOIP version: _V27 (02/01/09 21:14:12) 
Voice DSP version: 40533 


4.4.3 BRI/SO Voice Port Statistics 


The command to display statistics on a BRI voice port is (in this example, voice port number 0): 


CLI> show voice voice-port bri index 0 





voice port 5/0 
protocol descriptor BRI_NT 
config state down 
layer 1 status deactivated 
layer 2 status TEI , status 
attached voip dial peer 0 
number of voice communication 0 


Channel (s) used 


bri Tx frames on D channel 0 
bri Rx frames on D channel 0 
Outgoing calls 0 
Outgoing calls failures 0 
Unsufficient pots-group resource 0 
Physical Interface down 0 
Cause Class 0 (normal event) 0 
Cause Class 1 (normal event) 0 
Normal Cause (16) 0 
User busy (17) 0 
No answer (18) 0 
Cause Class 2 (unavailable resources) 0 
Cause Class 3 (unavailable service) 0 
Cause Class 4 (service not provided) 0 
Cause Class 5 (invalid message) 0 
Cause Class 6 (protocol error) 0 
Cause Class 7 (interworking) 0 
Incoming calls 0 
Incoming calls backup invoked 0 
Incoming calls failures 0 
Remote failure 0 
Unknown number 0 
DSP unavailable 0 
No VoIP ressource available 0 
Not specified 0 


Notes: 


Outgoing call statistics are related to the calls towards the ISDN device or network (transmitted by the 
OneOS-based voice-capable router on this port). 


Incoming call statistics are related to the calls coming from the ISDN device or network (received by 
the OneOS-based voice-capable router on this port). "Remote failure" indicates that the failure has 
occurred on the outbound port (VOIP or local). 
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e The layer 1 state (layer 1 status) may be deactivated if no communication is in progress. 


e Number of voice communications: 0, 1 or 2. Current number of communications in progress. 


e show voice voice-port bri all displays statistics on all the voice ports 


4.4.4 FXS Voice Port Statistics 


To show statistics on a FXS physical port, enter: 


Note: 


CLI> show voice voice-port fxs index 0 
voice port 


current State 

config state 

attached voip dial peer 
voice communication 


Outgoing calls 
Outgoing calls failures 


Unsufficient pots-group 


User busy 
No answer 


Incoming calls 


(17) 
(18) 


Incoming calls backup invoked 


Incoming calls failures 
Remote failure 
Unknown number 
DSP unavailable 


No VoIP ressource available 


Not specified 


5/2 
on hook 
up 
0 
no 
0 
0 
resource 0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 


e Outgoing call statistics are related to the calls towards the FXS device or network (transmitted by the 
OneOS-based voice-capable router on this port). 


e Incoming call statistics are related to the calls coming from the FXS device or network (received by the 
OneOS-based voice-capable router on this port). "Remote failure" indicates that the failure has 
occurred on the outbound port (VoIP or local). 


e Voice communication is indicated as "yes" if a communication is in progress. 


e show voice voice-port fxs all displays statistics on all the voice ports. 


4.4.5 PRI Voice Port Statistics 


The following command returns statistics about the physical E1/PRI port. 


CLI> show voice voice-port pri index 0 
voice port 


physical type 
protocol descriptor 
config state 

layer 1 status 
layer 2 status 


attached voip dial peer 


number of voice communication 


pri AIS occurrence 
pri RDI occurence 


Outgoing calls 
Outgoing calls failures 


Unsufficient pots-group 
Physical Interface down 


5/0 
El 
El PRI 
up 
activated 
TEI , status 
0 , established 








0 
0 
0 
0 
11358 
278 
resource 0 
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Cause Class 0 (normal event) 0 
Cause Class 1 (normal event) 277 
Normal Cause (16) 0 
User busy (17) 76 
No answer (18) 0 
Cause Class 2 (unavailable resources) 0 
Cause Class 3 (unavailable service) 0 
Cause Class 4 (service not provided) 0 
Cause Class 5 (invalid message) ay 
Cause Class 6 (protocol error) 0 
Cause Class 7 (interworking) 0 
Incoming calls 16408 
Incoming calls backup invoked 0 
Incoming calls failures 1411 
Remote failure 1411 
Unknown number 0 
DSP unavailable 0 
No VoIP ressource available 0 
Not specified 0 


Note: 


e Outgoing call statistics are related to the calls towards the ISDN device or network (transmitted by the 
OneOS-based voice-capable router on this port) 


e Incoming call statistics are related to the calls coming from the ISDN device or network (received by 
the OneOS-based voice-capable router 0 on this port). "Remote failure" indicates that the failure has 
occurred on the outbound port (VoIP or local). 


e The "number of voice communications" is the number of communications in progress. 


e show voice voice-port pri all displays statistics on all the voice ports. 


4.4.6 Dial Peer VoIP Statistics 


To show statistics for the dial-peer VoIP <port-—id>, use the following command: 


CLI> show voice dial-—peer voice voip index <port-id> [<type>] [reset] 


To show statistics for all the dial-peer VoIP, use the following command: 





CLI> show voice dial-peer voice voip all [<type>] [reset] 


type may be: 

e current: Statistics on current calls. 

e outgoing: statistics on outgoing calls only. 
e incoming: statistics on incoming calls only. 
e user-plan: statistics on voice & fax only. 


e all (default): all the statistics are provided. 


CLI> show voice dial-peer voice voip index 0 


Dial Peer 1 
Current protocol h323 
Current Calls 1 
Outgoing Calls 
Outgoing Calls 220 
Outgoing calls failures 14 
RAS Call Failures 0 
Admission time-out 0 
Admission Rejects 0 
H225/0Q931 Call failures 14 
Cause Class 0 (normal event) 0 
Cause Class 1 (normal event) 4 
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Incoming calls 


Cause 
Cause 
Cause 
Cause 
Cause 
Cause 


H245 Call 


Ci 
Cl 
Cl 
Cl 
Cl 
Cl 


Normal Cause (16) 
User busy (17) 
No answer (18) 


Lass 
Lass 
Lass 
Lass 
Lass 
Lass 


2 


Ou ws WwW 


7 


(unavailable ressources) 
unavailable service) 
service not provided) 
invalid message) 


( 
( 
( 
(protocol error) 
(interworking) 


failures 


Incompatible capabilities 


Protocol 
Internal call failures 





errors 


DSP unavailable 
Max-bandwidth exceeded 





Max-connection 


xceeded 


Gateway not registered 
Gateway status down 


Not specified 


Incoming Calls 


345 


Incoming calls failures 14 
RAS Call failures 
Gatekeeper Unavailable 
Admission Rejects 
Local Port Call failures 

H245 Call failures 
Incompatible capabilities 
Protocol errors 


Internal call failures 


DSP unavailable 


Unknown number 


Channel / port unavailable 
Max-bandwidth exceeded 





Max-connection 
Not specified 


Advice-of-charge 


RTP statistics 
Number 
Number 


Voice & Fax statistics 


xceeded 


of transmitted packets 





Number 
Number 


of received packets 
of transmitted bytes 





Number 


of received bytes 
of excessiv 





Number 
Number 


total 
565 


of lost packets 


jitter events 


of invalid packets 
Number of calls with frame error rate 
<0.1% 


<0.01% 
565 


Modem passthrough 
of switching to modem mode 


Number 
T38 FAX Calls 
Number 
Number 
Number 


Number 
Number 


of outgoing fax 
of incoming fax 


of failures 
Request Mode failure 


0 


<0.5% <1% 
0 0 





Pre-message procedure failure 
Page failure 
of transmitted packets 





Number 
Number 


of received packets 
of transmitted bytes 





Number 
Note: 


of received bytes 


of lost packets 


O-@: OO OF. OrO--O 
oO 


oo 








OO Or Oro. 2 


(=e) 


oo 


14 








rFOoOoOao°9o 


35 
40 
11620 
13280 


C 








@:C'S: ©: 'O'*O"'O"- OOOO 


e Outgoing call statistics are related to the calls towards the H.323/SIP network (transmitted by the 
OneOS-based voice-capable router to the remote VoIP device. 


e Incoming call statistics are related to the calls coming from the H.323/SIP network (received by the 
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OneOS-based voice-capable router from a VoIP device). "Remote failure" indicates that the failure 


has occurred on 


4.4.7 MOS Scoring 


The following command gives statistics about the voice quality: 


the outbound port (local). 


Statistics 





CLI> show voice mos 
Call Quality 

Number of Call = 10 
Average of MOS 7 3.58 
Minimum MOS 22.238 
Maximum MOS > 4.29 
Average of ERL 2 41 
Average of ACOM anon 
Average of loss-rate : 0 
Average of jitter : 14 
Average of Max delay : 16 














Use the following command to reset and restart the MOS scoring statistics: 


CLI> show 


voice mos reset 


4.4.8 H.323 Gateway Statistics 


The following command gives statistics about the gatekeeper: 


CLI> show voice h323-gateway 
H323-Gateway statistics 
State UP 
Bandwidth used/unused 174800 / 2897200 bps 
ax Bandwidth exceeded 0 


Registra 


tion state 





Gatekeep 
Gatekeep 
Registra 
Registra 





Admissio 
Admissio 


r Identifier 

er Address 

tion requests 

tion failures 

No response 

Invalid IP address 
Duplicate alias 
Invalid terminal type 
Ressource unavailable 
Invalid alias 
Security denial 
Undefined reason 

nh requests 

n rejects 

Called party not registered 
Invalid permission 
Request denied 

Caller not registered 
Resource unavailable 
Security denial 
Invalid Endpoint Ident. 
Incomplete address 
Not specified 
Undefined reason 








H323 resource threshold is Disable and NOT Active 


unregistered 


-0.0.0 


OOOO OOCOCCOCOOCOCOCCOOCOCOOCOCOOOC fo 
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4.4.9 SIP Gateway Statistics 


The following command gives statistics about the SIP proxy: 


CLI> show voice sip-gateway 


Gateway state up 
Registration state registered 
Registrar server 100.12.0.2:5060 
Registration errors 0 

Registration requests 2 

Current calls 0 
Authentication Rejects 0 


4.4.10 Events 


e Layer 1 on ISDN BRI port <5/x> <activated or deactivated>: ISDN layer 1 state 
(info). 





e Layer 1 Error on ISDN BRI port <5/x> : <activation failure / deactivation>: 
ISDN layer 1 error. Can indicate that the ISDN line is disconnected. 





e Layer 1 on El1/T1 port <5/x> <activated or deactivated>: G703/G704 state on PRI 
port. 





e Alarm on El1/T1l port <5/x>: <LOS, AI, RAI, End of LOS, End of AI, End of 
RAI>: Alarm detected on PRI port (compliant to G704). 














e FXS port <off-hook>, <on-hook>, <ringing on>, <ringing off>: Event on FXS 
analog port. 


e Voice port <5/x> status change <shutdown / no shutdown>: Indicates that the 
interface has been shutdown by the operator. The port cannot be used for calls. 


e H323 Gateway registered with the Gatekeeper <gk id>: gateway registered. 








e H323 gateway registration failure cause <cause>: registration failure. 





e Incoming call on <voip | local> port <n° port>, calling <E164 number>, 
called <E164 number>, call-id=<internal call identifier>: incoming call. 








e Outgoing call on <voip | local> port <n° port>, number <E164 number>, call- 
id=<internal call id>: outgoing call on a local or VoIP port. 


° Incoming call failure on <voip | local> port <n° port>, call-id=<internal 
call id>, cause: <cause>. Occurs when the call cannot be routed (wrong number, no 
resource). 

e Outgoing call failure on <voip | local> port <n° port>, call-id=<internal 


call id>, cause: <Q850 cause> or <RAS cause>. Occurs if a routed call is released before 
having reached the “ALERTING?” state. 


e Overlap dialing, call-id=<internal call id>, number: <digits>: sent for each digit received in overlap 
dialing mode. 


e Alert received, call-id=<internal call id>: the call has entered in “alerting” state. 


e Call connected, call-id=<internal call id>: the call is connected (signaling only). It 
does not mean that the voice path is established. 


e VoIP RTP transmission <started | stopped>, call-id=<internal call id>, 
coder <coder>: indicates that the OneOS-based voice-capable router has started (or stopped) to 
send RTP packets. 


e VoIP RTP reception <started | stopped>, call-id=<internal call id>, coder 
<coder>: indicates that the OneOS-based voice-capable router is able (or not able) to receive RTP 
packets. 


e VoIP media channel opening failure, call-id=<internal call id>, cause: 
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<H245 cause>: occurs if the media channel negotiation has failed. 


Call disconnection received on <voip | local> port <n°port>,, call- 
id=<internal call id>, cause : < Q850 cause>: indicates that a disconnection has been 
received. 


Local call disconnection, call-id=<internal call id>, cause: <internal 
cause>: disconnection sent by the OneOS-based voice-capable router upon an error (DSP down, 
media channel closed...). 


H245 <alpha | signal> <DIMF <number> | Hookflash> <sent | received>, 
callid=<internal call id>: occurs for each DTMF digit sent or received on the h323 part of 
the call. 


FAX T38 starting, call-id=<internal call id>: start of the T38 call. 





FAX T38 end of call, call-id=<internal call id>: end of the T38 call. 


FAX T38 call failure, call-id=<internal call id>, cause: <T38 cause>: indicates 
the cause of the T38 call failure. 








FAX T38 Pre-message procedure OK ,call-id=<internal call idb>: indicates that the 
T38 call is connected. 


FAX T38 <receiving | transmitting> page <n>, call-id=<internal call id>: 
indicates that the page n is being received / transmitted. 


FAX T38 page <n> <OK | KO>, call-id=<internal call id>: indicates that the page n 
has been received / transmitted OK or not. 


FAX T38 <n> IFP packets lost, call-id=<internal call id>: indicates a T38 
transmission error. 


FAX/Modem start of detection, call-id=<internal call idb>: indicates that a fax or 
modem call is being detected. 


FAX/Modem end of detection, call-id=<internal call id>: indicates that the detection 
phase has ended. 


DSP failure <dsp number>: <cause of failure>: indicates a DSP internal error (software 
crash). 





<number> invalid voice packets received, call-id=<internal call id>: number 
of invalid voice packets received. 


<number> voice packets lost, call-id=<internal call id>: number of voice packets 
lost. 


<number> excessive jitter, call-id=<internal call id>: the jitter is greater than the 
configured value. 





Reboot on voice call reception, call-id=<internal call id>: remote reboot 
command has occurred. 


Portability status: <done | in-progress | disable | enable>: indicates a change 
of the number portability state. 


Notes: 


<n°port> includes the B channel if the port type is BRI or PRI, except if it is not known (in TE 
emulation mode, for example). 


<internal call id> is a unique identifier for the call. 
<Q850 cause>: Refer to ITU-T Q.850 cause. 


<H245 cause>: May be "capabilities mismatch", "no remote opening channel", "H.245 protocol 
error”. 


Page 4.4-119 of 166 


ONEOS V4.2R5 VOICE USER GUIDE (EDITION 5) 





4.5 TROUBLESHOOTING TOOLS 


Events and statistics described above should be used first for troubleshooting call failure. This section 
describes other useful tools. 


4.5.1 LEDs 
On the front panel, two LEDs indicate the state of the voice service: 
4.5.1.1 |ONE200/400 
Led 'Voice': 
e Green: Voice service fully operational. 
e Blinking green: Voice service fully operational. No succeeded call yet. 
e Red: Voice service configured but not fully operational. 
e Off: The voice service is not configured. 
The voice service is fully operational if all these conditions are OK: 
e The IP interface attached to the h323/SIP gateway is UP. 
e The h323/SIP gateway is registered with a gatekeeper or registrar (if configured). 
e All the voice interfaces which are in “no shutdown” state are UP. By configuration, it is possible to 
exclude the voice interface from this condition (See voice-port). 
Led 'Com': 
e Green: At least one voice communication is established. 
e Off: No voice communication in progress. 
4.5.1.2 | ONE100/180/300 
Led 'Voice/Com': 
e Green: Voice service fully operational. 
e Blinking green: Voice service fully operational. Call in progress. 
e —_ Blinking orange: Voice service fully operational. No succeeded call yet. 
e Red: Voice service configured but not fully operational. 
e Off: The voice service is not configured. 
4.5.2 ISDN Signaling Capture 


It is possible to display all the ISDN protocol messages exchanged between the OneOS-based voice- 
capable router and the ISDN terminal. Such traces rely on the generic Logging function (cf. IP debugging 
in OneOS Book). 


Enter the following command: 
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CLI> [no] debug isdn { 5/<0..7> | 2/0 | all } [layer {1 ]2]|3 | 182 


| 2&3 | 1to03}] 


The first command argument is the ISDN port(s), whose ISDN messages will be logged. The second 
argument is the monitored ISDN layers (1: physical, 2: LAPD, 3: call control and other ISDN applicative 
messages). 


Example (ISDN Capture from a Telnet Session) 


CLL> 
CLI> 
CLI> 
ChL> 


configure terminal 
logging buffered debug 

debug isdn all layer 1to3 
monitor trace 


Unnumbered frame with a SETUP sent to an ISDN phone 
































line 
line 


line: 


line 
line 


line 
line 


takes the call 


line 
line 


line: 


line 
line 


line 
line 


line 
line 


line 


line: 


25/0 
25/0 


5/0 


25/0 J 
25/0 J 


25/0 
25/0 


25/0 


5/0 


25/0 
25/0 


25/0 
25/0 


5/0 


25/10 


25/0 


ngs up the handset 


00:07:21.271 
00:07:21.271 
00:07:21.271 
00:07:21.271 
00:07:21.271 
al 33 
00:07:21.272 
Layer 2 establishment 
00:07:21.343 
00:07:21.343 
00:07:21.343 
00:07:21.343 
00:07:21.343 
00:07:21.343 
The ISDN phone 
00:07:21.380 
00:07:21.381 
00:07:21.381 
00:07:21.381 
00:07:21.381 
00:07:21.381 
00:07:21.382 
00:07:21.382 
The ISDN phone 
00:07:21.412 
00:07:21.413 
00:07:21.413 
00:07:21.413 
00:07:21.413 
00:07:21.413 
00:07:21.413 
00:07:21.413 
00:07:25.349 
The user ha 
00:07:25.350 
00:07:25.350 
00:07:25.350 
00:07:25.351 
00:07:25.351 
00:07:25.351 
00:07:25.351 
00:07225.374 
00:07:25.374 
00:07:25.374 
00:07:25.374 


line 


line 


line 





line 


line: 


line: 


line: 


25/0 


5/0 


15/0 
5/0 


25/0 


L1 
L2 





frame sent. 

tx UI P/F=0 NR=4 NS=2 C/R=1. 
hex: 02 ff 03 

tx SETUP callref:8. 











Ll 





L2 


G1 
25/0 J 


L3 


Ll 





L2 


L1 
L2 





hexl: 08 01 08 05 04 03 80 90 a3 18 01 89 70 05 


hex2: 30 33 36 al 


frame received. 

rx SABME P/F=1 C/R=0. 

hex: OO O1 7f 

frame sent. 

tx UA P/F=1 NR=4 NS=2 C/R=0. 
hex: 0O 01 73 











frame received. 

rx I P/F=0 NR=0 NS=0 C/R=0. 
hex: 00 01 00 00 

rx CALL PROCEEDING callref:8. 
hexl: 08 01 88 02 18 01 89 
frame sent. 
tx RR P/F=0 NR=1 NS=2 C/R=0. 
hex: 00 01 01 02 


























indicates that the user is alerted (ringing) 


frame received. 

rx I P/F=0 NR=0 NS=1 C/R=0. 
hex: 00 01 02 00 

rx ALERTING callref:8. 














5/0 1] 
25/0 J 


Teal 
29/40 1 


Ll 


L2 


L3 


L1 
L2 





L3 


hexl: 08 01 88 01 le 02 81 82 
frame sent. 

tx RR P/F=0 NR=2 NS=2 C/R=0. 
hex: 00 01 01 04 

frame received. 











rx I P/F=0 NR=0 NS=2 C/R=0. 
hex: OO O01 04 00 

rx CONNECT callref:8. 

hexl: 08 01 88 07 4c 06 O01 80 33 30 33 36 
frame sent. 

tx RR P/F=0 NR=3 NS=2 C/R=0. 
hex: OO O01 01 06 

frame sent. 

tx I P/F=0 NR=3 NS=0 C/R=1. 
hex: O02 01 00 06 

tx CONNECT ACK callref:8. 
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00:07:25.374 


RR polling during the call 


00: 
00: 
00: 
00: 
00: 
00: 
00: 
00: 
00: 


O7: 
O7: 
O7: 
O7: 
O7: 
O7: 
O7: 
O7: 
O7: 


25. 
29% 
2538 
35% 
35% 
319s 
35% 
33.8 
3% 


391 
392 
392 
380 
381 
381 
394 
394 
394 


Remote disconnection 


DODD WDOOOCOCCOOOCOCCOOOOOOOOOOCO fo 
OOOO OOOO OC OO 'O'O". OC OOo C1 O'-O'O'O: Oo © 


OOO OO 0 
ooo OC O'oO 


fer} 
< 
o 
5 
nm 
2 








OOOO O0O 
OO OO :Ore 


is 


I 


OO OOO. OO OO; OG. OO: OO O'-O OO O'O' O'S: 3 


Oe 


COO OO; oO. O 


7 
: 
: 
7 
7 
: 


(2) 








(a ie ok a Yk o> Te oe a 


el 


238:. 
238. 
238. 
38: 
*3,3'. 
$335. 
233.8: 
738. 
#38: 
Heo ke 
38. 
738. 
2.38 
238. 
23.3". 
738. 
238° 
3.8% 
23.8% 
238% 
738: 
238: 
33.85. 
238% 


748. 
2:48. 
2:48. 
2:48. 
2:48. 
2:48. 


FOS. 
253s. 
253% 
753. 
£53. 
253% 


666 
666 
666 
666 
666 
690 
690 
690 
748 
7A 
7A 
7A 
7A 
7A 
7A 
749 
E52 
753 
753 
753 
753 
773 
773 
774 


WO WOO OO © 0 





761 
761 
761 
TED: 
775 
775 


onnection 


742 
742 
742 
‘bor 
7158 
7158 


line 


line 





line 


line 


line 
line 


line 
line 





line 





line 


line 
line 


line 
line 


line: 
line: 


line: 


line: 


line: 
line: 


line: 


line: 


line: 
line: 


line: 


line: 


line: 
line: 


line: 


25/0 1] 
5/0 1] 


5/0 
5/0 


25/0 


25/0 J 
5/0 1] 


25/0 
75/0 


5/0 


5/0 
5/0 


25/0 


5/0 


oH A) 
25.40 


5/0 


5/0 
25/0 


25/0 J 
25/0 J 


25/0 
25/0 


5/0 1 
5/0 1 


5/0 1] 
25/0 1 





L1 
L2 


L3 


L1 
L2 


hexl: 08 01 08 OF 


frame received. 

rx RR P/F=0 NR=1 C/R=1. 

hex: 02 01 01 02 

frame sent. 

tx RR P/F=1 NR=3 NS=0 C/R=1. 
hex: 02 01 01 O7 

frame received. 

rx RR P/F=1 NR=1 C/R=1. 

hex: 02 01 01 03 








frame sent. 

tx I P/F=0 NR=3 NS=1 C/R=1. 
hex: O02 01 02 06 

tx DISCONNECT callref:8. 
hexl: 08 01 08 45 08 02 80 90 
frame received. 
rx RR P/F=0 NR=2 
hex: O02 01 01 04 
frame received. 
rx I P/F=0 NR=2 
hex: 00 01 06 04 
rx RELEASE callref:8. 











C/R=1. 











NS=3 C/R=0. 











L1 
L2 


Ll 
25/0 J 


hexl: 08 01 88 4d 08 02 81 90 
frame sent. 

tx RR P/F=0 NR=4 
hex: 00 01 01 08 
frame sent. 
tx I P/F=0 NR=4 
hex: O02 01 04 08 
tx RELEASE COMPLETE callref:8. 











NS=1 C/R=0. 











S=2 C/R=1. 




















Ll 





5/0 1 
L2 


L2 


Ll 





L2 


Ll 





L2 


4.5.3 Call Generator/Responder 





hexl: 08 01 08 5a 08 02 81 90 
frame received. 

rx RR P/F=0 NR=3 C/R=1. 

hex: O02 01 01 06 











frame sent. 

tx RR P/F=1 NR=4 NS=2 C/R=1. 
hex: O02 01 01 09 

frame received. 

cx RR P/F=1 NR=3 C/R=1. 

hex: O02 01 01 O7 











frame sent. 

tx DISC P/F=1 NR=4 NS=2 C/R=1. 
hex: 02 01 53 

frame received. 

crx UA P/F=1 C/R=1. 

hex: 02 01 73 








The call generator enables to place calls automatically without voice terminals. This function makes it 
easier to validate and troubleshoot the installation of the VoIP router. 


Main features: 


e Defines a responder number: when the OneOS-based voice-capable router receives a call with this 
called number, it responds automatically to the call and provides a BERT or Loop service. 


e Provides CLI commands to initiate a call with a specific origin & destination number. 
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e Performs loop mode, BERT testing (BERT: Bit Error Rate Test for unrestricted data service over IP) or 
voice message generation with a test call. 


e Provides CLI commands to enhance setting of advanced features such as: 
e Periodic call generation. 


e Multiple call generation & answering. 


4.5.3.1 Responder 
4.5.3.1.1 Configuration 


The easiest method is to define a new ‘dial-peer voice pots’, which is not attached to a physical port, but 
which is able to provide a service (loop, BERT, voice message). 


Syntax: 


dial-peer voice pots <pots-id> 
service { loop | bert2047 { both | analyse | sending } | voice-message } 
[<number-of-simultaneous-calls>] 
pots-group <id> 
port 5/<x> 
exit 
Note: 


e Service could be: loop (loopback received voice flow), bert2047 (Bit Error Rate Test), voice-message. 


e The bert2047 could be: sending (send unrestricted data), analyze (receive data and determine 
loss/error) or both. 


e Voice-message is used to play-out or record a message file (G711 format). 


e The following optional number specifies the maximum number of simultaneous calls (the next call is 
rejected if the number of active call has reached this limit). Default: 1 


To disable the responder: 


dial-peer voice pots <pots-id> 
no service {loop | bert2047} 


4.5.3.1.2 Details about Responder Signaling 


The behavior is as simple as possible. The received call (SETUP message) is automatically accepted and 
a CONNECT message is returned as long as the maximum number of simultaneous call is not exceeded. 
If exceeded, the responder returns a DISCONNECT message with the following disconnect cause: 


44 [Requested circuit/channel not available] 


No timeout is engaged for DISCONNECT procedure. Only the calling port engages nominal disconnection. 


According to current route rules, only local (towards local port) calls are available. 


4.5.3.1.3 Details about the RTP Flow 


Depends on the service configured: 
e Loop: received RTP packets are looped after DSP decompression/compression process. 


e Bert2047: a BERT pattern is locally generated towards the calling port while received packets are 
processed in order to generate statistics. 


e Voice-message: either a specific frequency is generated or better a voice-message is locally 
generated. 
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4.5.3.2 Call Generator 


Two CLI commands are defined to initiate a call: Quick Mode and Multi-Session Mode. 
Quick mode 
A single CLI command (under the root) initiates a call: 
CLI> auto-call <called> <calling> <pots-number> { voice | data | 
voiceband } 
Parameters: 
e  <called>: called number. 
e <calling>: calling number. 
e <pots-number>: local dial-peer pots identifier to be used. 
The call default parameter values are the same as the multi-session one. 
Multi-session mode 


A CLI command set enables the configuration of several calling sessions. 


Qa 


configure 
voip-call 


LI ( )> voip-call <identifier> 

LI ( )> pots <pots number> 

LI (voip-call)> called <number> 

LI (voip-call)> calling <number> 

LI (voip-call)> bearer {voice | data | voiceband} 
LI (voip-call)> duration <0-1000000> 

LI (voip-call)> timeout <0-1000000> 

LI (voip-call)> start [auto] 

LI (voip-call)> stop 








C 
C 
C 
C 
C 
C 
Cl 
Cl 


To destroy a session: 





CLI (configure)> no voip-call <identifier> 


N.B.: In the following, [ ] means optional parameter; if absent, default value is selected. <identifier> 
is an ASCII string limited to 16 characters. 


Parameters: 


e pots: specifies the pots port to be used. The ‘dial-peer voice pots’ is a virtual pots and MUST NOT be 
bound to a physical port. The port must not be configured within ‘dial-peer voice pots’. The dial- 
peer voice pots remains ‘shutdown’. 


e called: called number (up to 22 characters <0..9,#,*,.,-). 

e calling: calling number (useful for local calls towards 5/x port for routing process). 

e bearer: bearer capability. 

e duration: call duration after connection (units in seconds). 

e timeout: time between the end of a call and the start of the next one (units in seconds). 

e start [auto]: start the call. The auto option allows starting automatically after a reboot. 
e stop [auto]: stop the call. The auto option removes the automatic starting after a reboot. 


By default, pots port is 0, call duration to 20 seconds and timeout to 10 seconds. If not defined, bearer is 
fixed to data. Several test call sessions can be configured simultaneously (with voip-call only). 
4.5.3.2.1_ | Details about Generator Signaling 


The behavior is as simple as possible. Only in-bloc dialing is supported. The call (SETUP message) is 
automatically sent after the “timeout” value specified in the voip-call command. 


When the call duration is over, a local disconnection (DISCONNECT) with normal cause value (16) is 
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generated. When the timeout is over, a call (SETUP message) is automatically sent, and so on and so on. 


If duration is equal to 0, the call is established and remains established forever until the STOP command 
disconnects the call. 


According to current route rules, local (towards local port) or remote (towards dial-peer voip) calls are 
available. 


4.5.3.2.2. Details about Generator Call Type (Service) 


Loopback 
If the loopback service is defined, all the received voice frames are sent back to the originator. 


If the voice information comes from a local port, the voice switching matrix is configured to loopback the 
G.711 samples. 


If the voice information comes from a VoIP port, the voice RTP frames are uncompressed, the matrix is 
configured to loopback the G.711 samples to the DSP, the voice information is compressed again before 
sending the RTP frames back to the originator. 


BERT 2047 


If enabled, the OneOS-based voice-capable router sends a BERT2047 sequence towards the remote end 
and tests the BERT sequence received from the remote end. 


Results are given in the statistics and with periodic events. 


A voice message, defined in a file, can be played out or recorded. The main application is voice quality 
monitoring. 


Voice-Message configuration: 


service voice-message { play | record } <filename> <value> 


filename: voice file name without extension (.alaw). 
value! 
e Number of times the message must be played out (0: continuous). 


e Maximum time of recording in record mode (1 — 180 seconds). 


The file is stored in the flash file system (root directory) with the ".alaw" extension. The file contains 
G.711 A-law samples in raw mode. It can be read (or created) on PC by any specialized audio application. 
The file size is equal to play-out duration x 1KB. 


The coder used in the message file is G711 A-law. It means that, in case of RTP using G729a, an 
encoding or decoding is performed after the play-out or before the recording. 


For the play-out function, the message is processed by the DSP exactly as voice samples received from 
the pots device: 






RTP flow 






Gain control, Echo- 
cancel, tone detection, 
voice coding 


Internal loop 





G711 samples 
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For the recording function, the message is decoded as any RTP flow and then stored in a file in G711 A- 
law format: 







Echo-canceller, voice RTP flow 


decoding 


Internal loop 


G711 samples 


Voice Message 


Either a specific frequency is generated or, better, a voice-message is locally generated. 


4.5.3.2.3. Example 


Call Generator: 





hostname CALL—GENERATOR 
dial-peer voice pots 6 
pots-group 6 
service bert2047 both 2 
no shutdown 
exit 
dial-peer voice voip 0 
sig-protocol sip 
gw-ip-address 20.223.1.2 
no shutdown 
exit 
voip-call test 
called 7777 
calling 2221111003 
pots 6 
bearer voice 
overlap 0 
duration 10 
timeout 5 
exit 
voice-routing 
route 10 
dial-peer voip 0 
prefix 7777 length 4 
prefix-type outgoing called last 
exit 
exit 











Call Responder: 


dial-peer voice pots 5 
pots-group 5 
service loop 2 
no shutdown 
exit 
voice-routing 
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route 2 
dial-peer pots-group 5 
prefix 217777 length 6 
prefix-type outgoing called last 
exit 
exit 


4.5.3.3. Statistics 
4.5.3.3.1 Events 


Some specific events were added for call simulator. 
Events are activated by the CLI command: event filter add vox factory all mem 


Example: 


Info VOX FACTORY Test 1 call-id: 13, ident: appell, CALL IN PROGRESS 


Calling=3000 Called=3003. 

Info VOX FACTORY Test 1 call-id: 14, CALL CONNECTED. 
Info VOX FACTORY Test 
Info VOX FACTORY Test 
Info VOX FACTORY Test 
Info VOX FACTORY Test 

















call-id: 13, ident: appell, 
call-id: 14, Begin test BERT 
call-id: 14, TEST BERT OK 























1 
1 
1 
1 











Info VOX FACTORY Test 1 call-id: 13, ident: appell, CALL OK wi 


g7lla. 


call-id: 13, ident: appell, CALL CONNECTED. 
1, Generate BERT 


th 








codec 








ED on 





Info VOX FACTORY Test 1 call-id: 13, ident: appell, CALL DISCONNECT 


pots cause=[Normal call clearing]. 
Info VOX FACTORY Test 1 call-id: 14, CALL DISCONNECT 
cause=[Normal call clearing]. 








4.5.3.3.2 Displaying Statistics 


A specific ‘show’ command is added: 


CLI> show voice voip-test 
Outgoing call tests 


test-id pots status outgoing failed bert_ko 








1 4 running 12345 23 7 
2 4 running 7865 120 50 


Incoming call tests 


pots incoming rejected bert_ko 








5 12345 23 6 
5 7865 120 80 


4.5.4 RTP Call Detailed Reports 


on 


voip 


The RTP session monitoring feature gives history information about MOS, jitter, and packet loss. The last 


200 calls and the current calls are monitored. 
To display the statistics: 


CLI> show voice rtpcall { short | full } { any | err } { all | 


min <vall> 


max <val2> | ind <value> } 


Two modes are available: 
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short: stat 


istics summary. 


full: all the statistics. 


A filter can be applied to get only the calls with errors: any or err. 


The calls are nu 
first calls can be 


Several options 
e ~=all:allthe 
e 


Example: 


mbered as following: the 1st is the most recent one and the last call is the oldest one. The 
in progress or not. 


are available to select the calls: 


calls from 1 to 100. 


min <valuel> max <value2>: all the calls between value1 and value2. 


ind <value>: the call specified by the value. 


CLI> show voice rtpcall short any min 1 max 3 
































1 01/04/01 O00h47m43s RTP 20.5.3.131:16418 - 200.15.0.152:16390 
Play time (voice) O0OhO0O0Om47s 
Tx Coder G729 / 20 ms ; Rx Coder G729 
RTP Packets RX / TX 2338 / 2337 
RTP Packet losté&discarded RX / TX (RTCP reported) 0/0 
Number of Excessive Jitter events 1 
OS-CQ / MOS-LO 3.95 / 4.00 
2 01/04/01 O0h47m24s RTP 20.5.3.131:16416 - 200.15.0.152:16388 
Play time (voice) O0OhO0O0Om46s 
Tx Coder G711 1 Law / 20 ms ; Rx Coder G711 A Law 
RTP Packets RX / TX 2337 / 2338 
RTP Packet losté&discarded RX / TX (RTCP reported) 0/0 
Number of Excessive Jitter events : 1 
OS-CcQ / MOS-LO 4.30 / 4.35 
3 01/04/01 OOh47m05s RTP 20.5.3.131:16414 - 200.15.0.152:16476 
Play time (voice) O0OhOOm00s 
Tx Coder -- / -- ms ; Rx Coder -- 
RTP Packets RX / TX 0/0 
RTP Packet losté&discarded RX / TX (RTCP reported) 0/0 
Number of Excessive Jitter events : 0 
OS-CQ / MOS-LO SS a 
In full mode: 


CLI> show voice rtpcall full any index 2 


2 — 01/04/01 O00h47m24s RIP 20.5.3.131:16416 - 200.15.0.152:16388 


Play time 
Tx Coder 





(voice) O0OhO0Om46s 


G729 / 20 ms Rx Coder G729 


1 





VAD enabled local / remote no / no 
ERL 32 dB 
ACOM 67 dB 
OS-CQ 3.95 
OS-LQ 4.00 
remote MOS-CQ 3.90 
remote MOS-LQ 3.90 
R 
719 | KKK KKK KKK KKK KKK KK KKK KKK KKK 
vara 
30 mn 


RTP Packets received 


(DSP / Uplink) 233°] 23371 
lost 0 


out of sequence 0 
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invalid : 0 


RTP Packets transmitted (DSP / Uplink) 


lost (RTCP reported) : 0 


Jitter parameter : 100 ms 
Number of Excessive Jitter events 











Excessive Jitter events 














2 | 
leit. 
0 30" Trt 2" 4' Bhs 8 Os S16" 
Jitter received (uplink) 
ax delay : 93 ms 
Delays (ms) >50 2100 3150 
b of occur. 2 0 0 
Interarrival max jitter : 9 ms 
Jitter received (DSP) 
ax delay : 93 ms 
Delays (ms) >50 >100 >150 
b of occur. 2 0 0 
Interarrival max jitter : 9 ms 
Frames with a delay >50 ms 
2 | 
1| * * 





oO 30" 1' 2' 4' Bt 2 Sle" 


Jitter transmitted (uplink) 
Max delay : 6 ms 


Delays (ms) >50 >100 >150 
Nb of occur. 0 0 0 
Interarrival max jitter : 1 ms 

(RTCP reported) : 2 ms 


2338 / 2338 
>200 >300 

0 0 
>200 >300 

0 0 
>200 >300 

0 0 


e ERL is the Echo Return Loss measured before echo cancellation. Acom is the echo return loss 





measured after echo cancellation. 


° OsS-cQ is the Mean Opinion Score Conversational Quality. MOS-LQ is the Mean Opinion Score 
Listening Quality. Remote MOS-CQ and MOS-LQ are the values as calculated by the remote end. 


e When a value has not been calculated, it is replaced by a “-- 
ERL & ACOM when an echo situation has not been encountered (an echo situation is a high 
transmitted audio signal and low received audio signal), no RTCP packets received. 


the 





“. Examples: uplink analysis is disabled, 


e Agraph indicates the time distribution of the errors. The 30 sec column indicates the number of errors 
occurred between 30 sec and 1 min after the beginning of the call. 


e For the jitter statistics, “delay” means the time between two packets decreased by the normal time. 
Example: a delay of 80ms for a 20ms coder sample length causes a jitter of 6(0ms towards expected 
value. 


e The inter-arrival jitter is calculated for each packet in conformance with the RFC3550. The indicated 
value is the max jitter observed during the call. 


e Agraph indicates the time distribution of the R factor minute by minute for the last 30 minutes of the 


call. 
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4.5.5 VoIP Call Detailed Reports 


A history of the last VoIP calls is offered with the information about: 
e Date &Time & Duration. 
e Calling & Called number. 
e Inbound & Outbound ports. 
e Cause of disconnection. 
e Summary of the RTP sessions. 
To display the statistics: 
CLI> show voice voip-call { any | err } { all | min <vall> max <val2> 
| ind <value> } 
Example: 
CLI> show voice voip-call any all 
1 —- Call from voip-group: 1 (Uplink), to voip-group: 0 call-id: 167 
calling : 7071, called : 0141877049 
setup time: 23/01/08 12h42m02s 
connexion time: 23/01/08 12h42m06s 


disconnected by remote voip: 1 cause :(16) [Normal call clearing] 
call duration: 00:01:08 





23/01/08 12h42m03s 


RTP Source ip :192.168.0.10 rtp:16438 /Dest ip :192.168.0.20 


rtp:16402 
Play time (voice) : OOh01m08s 
Tx Coder : G711 A Law / 40 ms ; Rx Coder : G711 A Law 
RTP Packets RX / TX : 1783 / 1784 
RTP Packet lostédiscarded RX / TX (RTCP reported) : 0 / 0 
Number of Excessive Jitter events : 0 











2 - Call from voip-group: 1 (Uplink), to voip-group: 0 call-id: 
(40) 
calling : 149288663, called : 0141877053 
setup time: 23/01/08 12h20m11s 
connexion time: 23/01/08 12h20m14s 
disconnected by remote voip: 1 cause :(16) [Normal call clearing] 
call duration: 00:15:10 





23/01/08 12h20m12s 


rtp:16398 
Play time (voice) : 00h15m10s 
Tx Coder : G711 A Law / 40 ms ; Rx Coder : G711 A Law 
RTP Packets RX / TX : 22805 / 22807 
RTP Packet lostédiscarded RX / TX (RTCP reported) : 0 / 0 
Number of Excessive Jitter events : 0 








4.5.6 Protocol Traces 


RTP Source ip :192.168.0.10 rtp:16434 /Dest ip :192.168.0.20 


Note: The following commands activate traces for debugging purpose only (they will be interpreted and 


analyzed by OneAccess employees. OneAccess does not provide any explanation for those traces): 


The following command displays the VoIP sessions contexts: 


CLI> show voice debug voip-session 


The following command, in global voice configuration mode, activates tracing the messages exchanged by 
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VoIP sessions: 


CLI> configuration terminal 
CLI (configure) > voice-global 
CLI (voice-global)> audit voip-session enable 
CLI (voice-global)> exit 
CLI (configure) > exit 
CLI> 
The status enable or disable (default) can be displayed using: 


CLI> show voice audit 


The exchanged messages are displayed using: 


CLI> show voice debug message-exchanges 


The following command activates SIP traces: 


CLI> [no] debug sip 


The following command activates H.323 traces: 
CLI> [no] debug h323 
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5 SIP PROXY 


The main functions of the SIP proxy are: 
e To deliver local SIP call switching in case of network failure (softswitch not reachable). 
e To provide an extended NAT SIP ALG. 


e To manage SIP calls with SIP-IP phones (wired or wireless IP phones). 





5.1 INTRODUCTION 


Let us take an example: SIP phones are connected to an OneOS-based voice-capable router. SIP phone 
call control should be managed by a softswitch. However, it is desired to hide the softswitch by the OneOS 
SIP proxy. The SIP phones talk to the SIP proxy, which makes the decision to switch the SIP call to 
another destination. Call switching refers to routing a call to an appropriate destination: the softswitch, or a 
local port (ISDN, FXS interfaces), or another IP phone attached to the LAN interface of the router. The SIP 
proxy can be configured such that the calls can be routed locally in case of connection loss to the 
softswitch. 


In the SIP terminology, the OneOS SIP proxy works as a B2B UA (Back-to-Back User Agent), which 
means it has got a user agent server interface (to receive calls from SIP phones) and a user agent client 
interface to place calls directed to the softswitch. The user agent client interface is actually the SIP 
gateway. 


5.1.1 Registrar and Registration to Softswitch 


The embedded registrar maintains a mapping table between the IP phone numbers and their dynamic IP 
addresses. The registrar is attached to one logical IP interface, such as the LAN interface. In other words, 
the OneOS-based voice-capable router can route a call to an IP phone, once the IP phone has registered. 
Otherwise, it is not able to locate the IP phone. 


When an IP phone registers, OneOS (if configured so) checks phone number and authentication data. 
The IP phone registration is not translated into a REGISTER message sent to the softswitch. The OneOS 
router registers all registered phone number to the softswitch. 


5.1.2 Call Routing 


Call routing re-uses the voice-routing module common to H.323 and SIP- gateway. 


If the SIP gateway is down (see ‘show voice sip-gateway’), the backup mode is enabled. One can 
envisage that the preferred path for call routing is to switch the call through the softswitch. In backup 
mode, calls can be switched by the SIP proxy, thereby enabling local calls while the softswitch cannot be 
reached. 


5.1.3 SIP Signaling Translation 
SIP signaling is processed by the SIP proxy, such that IP phone IP address is replaced by the router IP 


address. The change is done within "Contact" and "From" fields (if the fields are not FQDN). 
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If the SIP messages contain SDP information, the IP phone IP addresses are replaced by the router public 
IP address. 


The SIP proxy is due to be transparent to SIP advanced voice features controlled by the softswitch or the 
IP phones. 


5.1.4 NAT ALG 


On an interface where dynamic NAPT address translation is enabled, some protocols cannot function 
properly. The reason is that those protocols negotiate the opening of ports dynamically without being 
aware that the ports are not open by default by the NAPT function. A NAT Application Level Gateway is a 
function that inspects a protocol at the application level and extracts some interesting information to control 
the opening of ports within the NAPT module. 


The RTP proxy manages IP address/port translation for RTP flows. Local calls managed by the softswitch 
require that RTP flows be switched by the RTP proxy. In other words, local calls require router CPU. So 
the number of simultaneous calls managed by the router must be kept at a level allowed by the CPU. 


5.1.5 Basic Call Flow 


The standard case is that the SIP proxy acts as a relay for SIP signaling. Let us take an example first. The 
OneOS-based voice-capable router has got a LAN interface (192.168.1.1/24) and a WAN interface 
(10.2.3.4). The softswitch IP address is 10.3.1.1. 


IP phone ONE100 Softswitch SIP-UA 
1111@192.168.1.2 192.168.1.1  10.2.3.4 10.3.1.1 2222@20.1.1.1 


Invite: Voice routing 
2222@192.168.1.1 lookup 


From: 

1111@192.168.1.2 Forge new SIP we: 
message nvite: 
(translated SIP || 2222@10.3.1.1 — 
message From: nvite: 


including SDP) 1111@10.2.3.4 See 


Create one-way 1111@10.3.1.1 
RTP proxy NAT 


LAN to WAN) | TRYING 
TRYING 
nade 
TRYING ‘Transiate _—— 


OK with SDP Translate + 
[| Create one-way 
path established rs 
—_— 


= 


Translate BYE 
and destroy 
RTP proxy NAT 
sessions. 
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5.2 CONFIGURATION COMMANDS 


The SIP proxy is tightly integrated into SIP gateway architecture. In other words, the reader of the 
document should first master SIP gateway configuration before starting to configure the SIP proxy. 


The configuration steps are the following: 
e SIP server interface: configuration of SIP UA server and registrar. 
e VoIP dial-peer: configuration of SIP end-points. 


e  Voice-routing: definition of rules for call switching rules and preference. The information for 
authenticating registration is configured in voice-routing. 


5.2.1 SIP Server 


The SIP UA server must be configured to attach it to an IP address and configure the embedded registrar 
for IP phones. 


To enter in sip-server configuration mode and attach an IP: 

CLI (configure)> sip-server 

CLI (sipserv)> interface {fastEthernet <x>/<y> | bvi <id> | ...} 
The registrar can be enabled as follows: 


CLI(sipserv)> [no] registrar-hostname <string> 
CLI(sipserv)> registrar { required | optional } 





The registrar-hostname is the name used, instead of the IP address, to fill the CONTACT field of the 
2000K answer. The required mode indicates that the IP phone must be provisioned prior to registering. 
The optional mode allows the IP phone to register without being provisioned. To disable the registrar: 


CLI(sipserv)> registrar disabled 


The RTP port range and SIP signaling port can be configured as follows (default sig. Port UDP 5060): 

CLI (sipserv)> call-sig-port <udp-port> 

CLI (sipserv)> rtp-port-range <min> <max> 
By default, the SIP server replies 200 OK to legitimate REGISTER requests with an expiration timer equal 
to the requested expiration time. However, you can force this timer to a customized value: 


CLI (sipserv)> reg-ka <seconds> 


Finally the SIP server must be activated as follows: 


CLI(sipserv)> no shutdown 
CLI (sipserv)> exit 


5.2.2 VoIP dial-peers 


From the signaling perspective, there is no difference in SIP protocol if the VoIP peer is a softswitch or a 
standard user agent (like an IP phone). Therefore, IP phones are declared as VOIP dial-peers like the 
softswitch. However, the difference is that OneOS may not know the IP address of such dial-peers in 
advance. Some extra attributes under ‘dial-peer voice voip’ are added to designate dial-peer whose 
IP is learnt through a registration process. 


First enter in ‘dial-peer voice voip’ configuration mode: 


CLI (configure) > dial-peer voice voip <0..7> 
CLI (voip)> sig-protocol sip 
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Then, the SIP UA type must be explicitly defined in case of an IP phone: 
CLI(voip)> sip-ua {ip-dynamic {restricted | open} | ip-static 
<A.B.C.D> | mac-static <aa:bb:cc:dd:ee:ff>} 
Explanation of the various modes: Several application cases are supported: 


e IP phones without configuration (except SIP proxy & registrar IP address): in such case, the IP Phone 
is identified by its IP address or MAC address. The ip-static of mac-static mode will be used 
and a dial-peer voip will be defined for each IP phone. If the registration process is used, the 
phone number is configured in the voice routing table: the sip id or the phone number that is indicated 
by the IP phone is not taken into account. In that case, you must configure as much dial-peers as IP 
phones. 


e IP phones with a configured phone number and able to support registration: in such case, a single 
dial-peer VoIP is defined in ip—dynamic mode. In this mode, two behaviors are possible : 


e Restricted mode (default): the phone number must be configured in the routing table. If not, the 
register request is refused. 


e Open mode: an entry is automatically created in the routing table for each IP phone (not saved if 
reboot or power-off). 


In case the dial-peer is an IP-PBX, it might be interesting to monitor its status by sending periodically SIP 
OPTION messages. As long as OPTION messages are acknowledged, calls can be routed to that dial- 
peer. To configure dial-peer monitoring (default: disabled): 


CLI (voip)> sip-monitoring <seconds> 
CLI (voip)> no sip-monitoring 
To complete the dial-peer configuration: 


CLI (voip)> exit 
5.2.3 Voice-Routing 


You can define in voice-routing the preferred call switching path for IP phones. 
To enter in voice-routing configuration mode and create a voice route: 


CLI (configure) > voice-routing 
CLI (voice-route)> route <0..200> 
CLI (conf-voice-route) > 


Then, associate a phone number to the IP phone ‘dial-peer voice voip’ configured before: 
CLI (conf-voice-route)> prefix <phone-nbr> length <length> 
CLI (conf-voice-route) > dial-peer voip <voip-dial-peer-id> ua-sip 
You can define authentication: 
CLI (conf-voice-route) > sip-uas-—authentication <username> <password> 


[<type>] 


If the command above is entered, authentication is mandatory for registration request coming from IP 
phones. The command ‘sip-authentication’ serves to authenticate the registration of the OneOS- 
based router to the softswitch registrar. In other words, the username/password used for authentication on 
IP phone and softswitch side can be different. The optional parameter t ype allows hiding the password in 
the CLI text file and for a “show running-config” command. The type ‘0’ indicates that the password 
must be encrypted. The type ‘1’ indicates that the password is encrypted. If type is absent, then the 
password is not encrypted. 


Not all commands under voice-routing are detailed here. Please refer to 4.2.11.5. 
Finally, complete the configuration as follows 


CLI (conf-voice-route)> exit 
CLI (voice-route)> exit 


Page 5.2-135 of 166 


ONEOS V4.2R5 VOICE USER GUIDE (EDITION 5) 


5.2.4 SIP Proxy with Transcoding Capability 


By default, the RTP packets are NAT-ted if the RTP stream is sent over NAT-ted SIP gateway interface. In 
that case, the SIP proxy modifies the SDP part of SIP signaling like a SIP NAT ALG. 


OneOS SIP proxy supports also an RTP proxy that makes it possible to transcode an RTP stream 
(example: G.711 on LAN to G.729 on WAN, G.711 on LAN to T.38 on WAN). In that case, a call is split 
into two independent LAN and WAN call legs. The RTP streams are terminated in OneOS DSP, where 
they are decoded and then encoded in the codec of the other call leg. 


Benefits of RTP proxy: 


e Consistent media behavior seen by the SIP network (codec negotiation, DTMF...), independently from 
the IP-PBX behind the OneOS-based voice-capable router. 


e Solves interoperability issues with T.38. 
Drawback of RTP proxy: 


e A proxied call without transcoding takes approximately as much DSP resources as making one G.729 
call from the SIP gateway. Without RTP proxy, no DSP resource is involved. 


The default mode is to not use the RTP proxy. To enable the RTP proxy: 


CLI (configure) > voice-global 
CLI (voice-global)> sip-proxy back-to-back 


To set the default mode (without RTP proxy): 
CLI (voice-global)> sip-proxy bridge 


If RTP proxy is enabled, the voip-coder-profile as well as the modem/fax handling must be set on 
the VOIP dial-peers. Example: 


configure terminal 


! dial-peer with IPBX 
dial-peer voice voip 0 
Sig-protocol sip 
fax-relay passthrough 
modem-passthrough 
passthrough-mode reinvit 
voip-coder-profile 0 
no shutdown 
exit 





! dial-peer with SIP application server (external trunk) 
dial-peer voice voip 1 

Sig-protocol sip 

dtmf-relay in-band 

fax-relay t38 

modem-passthrough 

passthrough-mode reinvit 

voip-coder-profile 1 

no shutdown 

exit 





exit 


5.2.5 Statistics and Debug 


To activate the SIP server debug traces (displays the information extracted from SIP signaling on the SIP 
server side), enter the following command: 


CLI> debug sip-registrar packet all 


To disable the traces, enter no debug. The raw SIP signaling is viewed by means of the ‘debug sip’ 
command. 
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To display the status of the SIP UA Server, enter the next command: 


CLI> show voice sip-server 
Sip-Server statistics 
Server state 
Registration requests 
Registrar server 


up 
2 


Current call 


192.100.100.1:5060 


To display the SIP phones currently registered with the internal SIP Server, use the next command: 


CLI> show voice sip-server endpoints 


phone 3 
Number 2409995773 
IP address 192.100.100.150 
SIP-id 2409995773 
Registration time lh 50m 14s 
Registration timeout 396s/600s 
phone 5 
Number 2409995774 
IP address 192.100.100.12:5060 
SIP-id 2409995774 
Registration time lh 50m 15s 
Registration timeout 572s/600s 


To display the phone numbers of the SIP gateway currently registered with the softswitch, use the next 


command: 


CLI> show voice sip-gateway endpoints 


If you are passing calls through the SIP proxy and NAT is required, the corresponding sessions appears in 


the NAT session table. See the next ‘show’ command: 


CLI> show ip nat sessions 


The following commands activate traces for debugging purpose only (they will be interpreted and analyzed 
by OneAccess employees. OneAccess does not provide explanation for those traces): 


CLI> trace filter add vox voiproute 2 show 
CLI> trace filter add vox sip autom 2 show 


5.2.6 Configuration Example 


In this configuration example, the softswitch is reached via its IP address 200.15.0.53 via the atm 0.1 
interface. Two IP phones are configured: they have a dynamic IP address and have the phone number 


1111 and 2222. The IP pho 


nes register to the OneOS-based voice-capable router via the LAN interface: 


! Dial-peer for softswitch 

dial-peer voice voip 0 
sig-protocol sip 
gw-ip-address 200.15.0.53 
voip-coder-profile 0 
no shutdown 

exit 

! Dial-peer for IP phones 

dial-peer voice voip 1 
sig-protocol sip 
voip-coder-profile 0 
sip-ua ip-dynamic restricted 
no shutdown 

exit 

voice-routing 

! First route: call is switched by softswitch 

! If softswitch is not present 
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route 10 
dial-peer voip 0 
prefix . length 4 


prefix-type outgoing called backup 
no loopback-routing 

exit 

route 11 
dial-peer voip 1 ua-sip 
sip-authentication userl passwordl 
prefix 1111 length 4 
prefix-type outgoing called last 
Loopback-routing 

exit 

route 12 
dial-peer voip 1 ua-sip 
sip-authentication user2 password2 
prefix 2222 length 4 
prefix-type outgoing called last 
lLoopback-routing 

exit 

exit 

sip-gateway 

gw-interface atm 0.1 intrusive 
reg-ka 120 

reg-dns-add 200.15.0.33 
device-host-name mydomain.com 
uri-contact ip-address 

no shutdown 

exit 

sip-server 

interface fastethernet 0/0 
registrar required 
registrar-hostname mydomain.com 
no shutdown 

exit 
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INTRODUCTION 


The Call Admission Control (CAC) is a feature that is involved to accept incoming and outgoing call. It 
makes sure that enough bandwidth is available before call establishment on an interface in order to 


sustain voice quality after call establishment. 


CAC is available for SIP gateway, H.323 gateway and SIP proxy. 


The RTP is the real time protocol transporting voice: the required bandwidth for each voice call must be 
available. To calculate the bandwidth, all the elements of a packet must be considered: 


Voice payload (see table hereafter). 


IP/UDP header: 28 bytes. 
RTP header: 12 bytes. 


IP encapsulation in the WAN interface: it depends of the interworking protocol. 


If applicable, ATM AAL5 encapsulation (depending on the packet length). 


Units used in the table: 


Period: sampling in milliseconds. 


Length: in bytes. 


Bandwidth: in bit per second (bps). 


















































Length Bandwidth requirements 
Period Packet/sec Voice only with IP Ethernet ATM IP only 

10 100 80 120 126400 127200 96000 

20 50 160 200 95200 106000 80000 
G.711/CES 

30 33.33 240 280 84792 84792 74659 

40 25 320 360 79600 84800 72000 

10 100 10 50 94400 84800 64000 

20 50 20 60 63200 63600 48000 
G.726 32Kbps 

30 33.33 30 70 52795 56528 42662 

40 25 40 80 47600 53000 40000 

10 100 10 50 70400 84800 40000 

20 50 20 60 39200 42400 24000 
G729AB 

30 33.33 30 70 28797 28264 18665 

40 25 40 80 23600 21200 16000 
G.723.1 5.3 30 33.33 20 60 26131 28264 15998 
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Length Bandwidth requirements 
Period Packet/sec Voice only with IP Ethernet ATM IP only 
60 16.67 40 80 15736 14136 10669 
90 11.11 60 100 12265 14132 888 
30 33.33 24 64 27197 28264 17065 
G.723.1 6.4 60 16.67 48 88 16803 14136 11736 
90 11.11 72 112 13332 14132 9955 
































Note: the ATM bandwidth is identical whatever the IP encapsulation IPoA & PPPoA VC-Mux or LLC-Mux, 
because the AAL5 encapsulation overhead and padding is taken into account. 


6.1.1 Call Admission 


The CAC bandwidth is configured as the layer-2 bandwidth corresponding to gw-interface 
encapsulation. If the gw-interface is attached to ATM 0.1 (IPOA encapsulation), G.729@20 ms 
requires 42.4 kbps. 


When an outbound call is placed (from OneOS-based voice-capable router to VOIP network), the available 
bandwidth is decremented by the layer-2 bandwidth required by G.711 (or the most bandwidth consuming 
codec). Taking G.711 is a conservative solution (worst case). 


When an inbound call is received (from VOIP network, destined to OneOS-based voice-capable router), 
the available bandwidth is decremented by the bandwidth corresponding to the requested codec. For 
example, if a call requires the use of G.729A@20 ms on an ATM interface, the available bandwidth is 
decremented by 42.4 kbps on an ATM interface. If the call requires that the RTP stream is sent to the LAN 
(whereas SIP-gateway is attached to another interface such as ATM 0.1), no CAC is performed. This case 
relates to an IP phone sending its RTP stream directly to the IAD (call between an IP phone and a FXS 
subscriber). In case of inbound calls, if the SDP in INVITE indicates that the receiver is the IAD itself, this 
INVITE is always accepted (because it is a local call). 


The available bandwidth must be greater than 0 after decrementing available bandwidth, otherwise the call 
is rejected. 


The available bandwidth does not result from sums/subtraction of bandwidth for the various codec. The 
bandwidth is evaluated dynamically. When the CAC function is called, the used bandwidth is calculated as 
the effective bandwidth sent by DSP through the gateway interface (such as ATM 0.1) + bandwidth from 
Sip phones. 


The bandwidth is calculated based on interface type which the gateway interface is attached with. 


To make things clear, let us imagine an OneOS-based voice-capable router with 2 SIP phones and 2 FXS 
phones. The SIP-gateway is attached to ATM 0.1 (IPOA encapsulation). The CAC bandwidth is 160 kbps. 
A G.711 call requires 106 kbps and a G.729 call requires 42.4 kbps. 
































Active Calls New Call CAC Result 
1 FXS call (G.729) 1 FXS call to VOIP Estimated bandwidth = 1 x G.729 + 1 x G.711 = 148.4 kbps 
to VoIP network network CAC test passes. 
1 FXS call (G.711) 1 FXS call to VOIP Estimated bandwidth = 2 x G.711 = 212 kbps 
to VoIP network network CAC test fails. 
1 FXS call (G.729) 1 SIP phone call to Estimated bandwidth = 1 x G.729 + 1 x G.711 = 148.4 kbps 
to VoIP network VOIP network CAC test passes. 
1 FXS call (G.711) 1 SIP phone call to Estimated bandwidth = 2 x G.711 = 212 kbps 
to VoIP network VOIP network CAC test fails. 
1 FXS call (G.711) 1 SIP phone call to Estimated bandwidth = 1 x G.711 = 106 kbps 
to VoIP network LAN network CAC test passes. 





6.1.2 Media Renegotiation 


When the codec is changed, it is assumed that media re-negotiation takes place; possible methods: 


e H.323 request mode 
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e H.323 TCS null 
e =6SIP re-INVITE 
e Pass through mode (switching directly from G.729 to G.711 without notifying remote party). 


The same CAC function is used to accept or reject the media change. When the media is renegotiated, the 
media change can be rejected if it requires more bandwidth than available and if renegotiation was 
invoked by SIP re-INVITE or H.323 request mode. In case of H.323 TCS null or pass through mode, the 
call is released directly if the CAC refuses media change. 
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6.2 CONFIGURING AND CONTROLLING CAC 


The bandwidth must be specified as the throughput on the line. It must take into account the RTP stream + 
RTCP (ca 5% of RTP throughput). 


To specify the maximum bandwidth under H.323 gateway: 

CLI (configure) > h323-gateway 

CLI (h323gw)> [no] max-bandwidth <0-3000000> 
Some additional commands are available: 


CLI (h323gw)> [no] bandwidth-control ratio <ratio%> [rate {current-rate | 
max—-rate}] [switch <number of possible calls switching to g711>] 

CLI (h323gw)> [no] gw-interface-bw-ctrl 

CLI (H323gw)> [no] dynamic—coder-selection 





The gw-interface-bw-ctrl1 command specifies that the real gateway interface bandwidth has also to 
be taken into account (e.g. ATM 0.1 synchronized with DSL might have various synchronization speed). 
The ratio is a percentage of available bandwidth for voice (default: 100%). The CAC is calculated for the 
following bandwidth: ratio x MIN(max-bandwidth, interface-bandwidth). When the CAC 
checks if a call can be admitted, it checks that there is enough bandwidth for the new call (even if the call 
is finally established in G.729). Additionally, if the switch parameter is set (default: 0 number of calls 
switching to G.711), the CAC checks also that there is enough bandwidth for a number of calls upgrading 
their media to G.711. If the rate parameter is max-rate, all active calls are counted as taking the 
bandwidth of a G.711 call (default behavior corresponding to older OneOS versions). It is then advised to 
set the rate parameter as current-rate: the bandwidth of all active calls taken into account by CAC is 
the real one. 


The dynamic-coder-selection command specifies that OneOS can choice the type of voice coder to 
better manage the available bandwidth. Refer to 4.1.5.2 for more information. 


Recommended parameter set: 


CLI (configure) > h323-gateway 

CLI (h323gw)> [no] max—-bandwidth <0-3000000> 

CLI (h323gw)> [no] bandwidth-control ratio 100 rate current-rate 
CLI (h323gw)> [no] gw-interface-bw-ctrl 

CLI (H323gw)> [no] dynamic—coder-selection 


For the SIP gateway: 


CLI (configure) > sip-gateway 

CLI (sipgw)> [no] max-bandwidth <0-3000000> 

CLI(sipgw)> [no] bandwidth-control ratio 100 rate current-rate 
CLI (sipgw)> [no] gw-interface-bw-ctrl 

CLI (sipgw)> [no] dynamic-coder-selection 


For the SIP server: 


CLI (configure) > sip-server 

CLI(sipserv)> [no] max-bandwidth <0-3000000> 

CLI(sipserv)> [no] bandwidth-control ratio 100 rate current-rate 
CLI(sipserv)> [no] interface-bw-ctrl 

CLI(sipserv)> [no] dynamic-coder-selection 

A counter for rejected calls can be seen with the command: 


CLI> show voice dial-peer voice voip <id> 


Also, media change and call rejection can be seen with event command: 


CLI> event filter add vox all show 
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7 MEDIA GATEWAY CONTROL PROTOCOL 

7.1 INTRODUCTION 
The OneOS-based voice-capable router enables the connection of conventional analog telephone 
terminals, or PBXs (analog), to the PSTN through a VoIP network compliant with MGCP 1.0. The OneOS- 
based voice-capable router is a voice gateway and interworks with a Call Agent (the softswitch in MGCP 
terminology). 

7.1.1 MGCP Protocol Overview 


7.1.1.1. Signaling Processing 


The OneOS-based voice-capable router implements the MGCP 1.0 protocol in conformance with: 
e IETF RFC 3435, 2705 (MGCP 1.0) 

e |IETF RFC 2327 (SDP) 

e IETF draft-andreasen-mgcp-fax-04 (for FAX support) 


7.1.1.2 Call Agent 


The call agent is defined by its IP address, which is configurable. 


The OneOS-based voice-capable router is identified by a configurable string of character. It can be for 
example a Domain Name, a MAC address (in such case, the MAC address must be entered in ASCII 
mode). 


Each voice port is identified by an endpoint name which is a string of character. The recommended value 
is "aaln/x" where x is the port number. 


The connection status is reported in the statistics. 


7.1.1.3 Tones & ringing 


The OneOS-based voice-capable router sends configurable tones & ringing signals, when requested by 
the call agent. 


Several profiles are defined: France, United Kingdom, Germany, Spain, Italy, and USA. 


A user-defined profile can be configured as well. 


7.1.1.4 Caller Identification 


The OneOS-based voice-capable router generates the appropriate information about the caller number 
during the ringing signal. Two modes are supported: FSK or DTMF. The initial ringing duration is 
configurable. 
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7.1.2 Backup 


The ONE100 has an optional FXO port for a backup purpose. It can be used to offer a backup service in 
case of failure on MGCP (uplink down, Call Agent unreachable...). 


The operation is as follows: 


Upon a failure on MGCP, a busy tone is sent to all the phones which are in an off-hook state. 


The signaling of the FXS ports is then handled locally by the ONE100 through voice-routing, as 
described in the H323/SIP chapter (see 4.1.4). It becomes possible to make calls between the FXS 
ports and the FXO port with an optional emergency procedure. 


If the MGCP call agent becomes reachable, the existing calls on FXS ports are maintained. When the 
FXS ports come back to on-hook state, they are handled again by the MGCP call agent. 


7.1.3 Voice Processing 


These coders are supported: 


G.711 A law (64Kbps) 

G.711 u law (64Kbps) 

G.729A (8 Kbps, no silence suppression) 
G.729AB (8 kbps, optional silence suppression) 


The RTP/RTCP protocol is used for voice packet transmission. 


The transmission periodicity is configurable at 10, 20, 30, 40 ms for G.729A/AB, G.711 and CES. The 
OneOS-based voice-capable router accepts any periodicity on the reception flow and supports the 
asymmetric coding mode (for example: transmission in G.729, reception in G.711). 


The RTP is a real-time protocol: the required bandwidth for each voice call must be available. 


To calculate the bandwidth, all overheads of a packet must be considered: 


Voice payload (see table hereafter) 

IP/UDP header: 28 bytes 

RTP header: 12 bytes 

IP encapsulation in the WAN interface: it depends of the interworking protocol 


If needed, ATM AAL5 encapsulation (depending on the packet length). 


Units used in the table: 


Period: sampling in milliseconds 
Length: in bytes 
Bandwidth: in bit per second (bps) 


























Length Bandwidth requirements 
Period Packet/sec Voice only with IP Ethernet ATM IP only 
10 100 80 120 126400 127200 96000 
20 50 160 200 95200 106000 80000 
G.711/CES 
30 33.33 240 280 84792 84792 74659 
40 25 320 360 79600 84800 72000 
10 100 10 50 70400 84800 40000 
20 50 20 60 39200 42400 24000 
G729AB 
30 33.33 30 70 28797 28264 18665 
40 25 40 80 23600 21200 16000 
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7.1.3.1 


7.1.3.2 


7.1.3.3 


Note: the ATM bandwidth is identical whatever the IP encapsulation IPoA & PPPoA VC-Mux or LLC-Mux, 
because the AAL5 encapsulation overhead and padding is taken into account. 


The silence suppression is compliant with the standard referenced in G.729AB. For the other coders 
(G.711), silence is suppressed using an optional comfort noise generation (the noise level is sent 
periodically to the remote end) in conformance with RFC3389. 


Group 3 FAX Processing 


Transparent Mode 


The G3 FAX can be transported by using G.711 coding. OneOS automatically disables the Echo Canceller 
if a G3 FAX is detected (optional) or switches the echo-canceller to a specific mode. The G.711 coder can 
be selected per configuration or dynamically during a voice communication when a modem or FAX is 
detected: this mode is called "Modem pass through". 


FAX Pass through 
Two methods can be used: 


1. The OneOS-based voice-capable router can directly switch to a G711 coding mode dynamically 
during a voice communication when a Group 3 FAX is detected. The Echo Cancellation remains 
enabled but in a specific mode (for G3 FAX). 


2. The OneOS-based voice-capable router informs the Call Agent that a G3 FAX tone is detected. 
Then the call agent switches the connection to G711. 


FAX Relay 


The OneOS-based voice-capable router also supports FAX Relay compliant to ITU-T T.38 (UDP mode). 
The signal is modulated & demodulated locally, the T.30 messages are analyzed and relayed, and the fax 
data are transported transparently over IP/UDP. The V.27 ter (4800 bps) and V.29 (9600 bps) modulations 
are supported. The OneOS-based voice-capable router offers FAX Spoofing to avoid FAX failures in case 
of long transit delays over IP. 


The T.38 session is initiated by the Call Agent when the CPE indicates that a G3 FAX tone is detected. 
Modem Processing 


Transparent Mode 


A Modem signal can be transported by using G.711 coding mode. OneOS automatically disables the Echo 
Canceller if a modem is detected. The G.711 coder can be selected by configuration for each port. 


Modem Pass through 


The OneOS-based voice-capable router can switch to a G.711 coding mode dynamically during a voice 
communication when a modem or Super Group 3 FAX is detected. The echo-cancellation is automatically 
disabled. Several methods are proposed to force the communication to G711: 


e Direct mode: proprietary method consisting in switching the RTP flow to G.711 without notifying the 
call agent. 


e The OneOS-based voice-capable router indicates the Call Agent that a modem tone is detected (the 
Echo Canceller is disabled). The Call Agent switches the coding mode to G.711 by modifying the 
connection. 


DTMF Processing 


DTMF can be processed by using the DTIMF MGCP package. The DTMF codes are detected in the 
received voice signal, suppressed before sending the RTP flow and regenerated at the remote end. The 
DTMF level and duration are configurable. 


The DTMF can also be transported transparently in the RTP flow by using the RFC2833 (or directly in case 
of G.711); in that case, the voice frames are replaced by special RTP frames containing only information 
about the DTMF code. This is the recommended method. 
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7.2 CONFIGURATION 


7.2.1 Introduction 
A set of command lines (CLI) enables the configuration of all necessary parameters. The configuration 
includes the following main commands: 


e Voice-port: Physical FXS port. Voice processing parameters are defined such as echo cancellation, 
gain and coding law. 


e __ Dial-peer voice: Logical internal ports. 


e Pots: Local voice port always associated with a physical port. It enables the configuration of groups, 
direct call and number transformation. 


e VoIP: MGCP endpoint. The coder profile and how to process DTMF and FAX/Modem are defined 
here. 


e VolP-coder-profile: to define a list of coders to be negotiated during capabilities exchange. 


e MGCP-gateway: defines all the parameters related to the MGCP protocol (Call Agent, gateway 
identifier). 


The relationships between configuration items are described in the following diagram: 


voice-port 


#phy. port 


mgcp-gateway 















dial-peer 
voice pots 


dial-peer 
voice voip 





physical port 





#profile 


voip-coder-profile 


The following sequence for configuration is preferred: 
1. voice ports 

2. dial-peer voice POTS 

3. voip coder profiles 

4. dial-peer VoIP 

5. MGCP gateway 


7.2.2 Configuration 


All the parameters enter in effect immediately, except a few parameters specified in MGCP-gateway. For 
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these parameters, a shutdown command of the MGCP-gateway is required (this requirement is indicated 
by a Warning message). 


7.2.3 Physical Voice Ports 


The OneOS-based voice-capable router voice module is always designated by the number 5. On a FXS 
module, the physical port is identified with a port number in the [0..(n-1)] range, where n is the total port 
number of the interface module (currently up to 8). 


Command for creation of physical port #0 (voice module #5): 


CLI (configure) > voice-port 5/0 
7.2.3.1 Parameters for Echo Cancellation 


Use the following command to enable the echo canceller - default: enable. Use the no form to disable 
echo cancellation. 


CLI (voice-port)> [no] echo-cancellation 
Use the following command to define the maximum tail length; ‘low’ is 8ms, 'medium' is 16ms, 'high' is 32 
ms. It must be configured 'medium' or ‘high’ if off-net calls must be supported (default value: 'medium’). 
CLI (voice-port) > echo-cancellation-length { low | medium | high } 


On ONE300, 30 voice channels can only be supported if echo-cancellation low or medium is 
selected. 


Use the following command to specify the conditions for automatically disabling the echo canceller - 
default 'not configured’ -. If configured modem, the echo canceller is disabled upon detection of a modem 
tone but not re-enabled at the end of the modem session (it will be re-enabled for the next communication). 
If configured voicemodem, the echo canceller is automatically disabled upon detection of a Group 3 FAX 
tone (it will be automatically re-enabled at the end of the modem session). If the modem passthrough 
function is enabled, the echo canceller is also disabled upon modem detection whatever the configuration 
of this parameter. 


CLI (voice-port)> echo-disable { voicemodem | modem } 
7.2.3.2. Parameters for Gain control 


Use the following command to set the output gain (dB) that amplifies the signal for the voice flow sent to 
the remote VoIP peer - default: 0 (no gain). 

CLI (voice-port)> output-gain <gain> 
Use the following command to set the input gain (dB) that amplifies the signal for the voice flow received 
from the remote VoIP peer - default: 0 (no gain). 


CLI (voice-port)> input-gain <gain> 
7.2.3.3 Parameters for Ringing 


For analog ports only, use the following command to specify the ring signal parameters. The frequency 
used is compliant to these country specifications. Default: France. 
CLI (voice-port)> ring { France | Germany | USA | Italy | Spain | UK | 
userdefined } 
Use the following command to define the ringing parameters for the userdefined ringing profile. freq is 
the frequency from 0 to 60 Hz, ton/toff are the emission/pause durations in ms (0-5000). 


CLI (voice-port)> user-ring <freq> <ton-1> <toff-1> <ton-2> <toff-2> 


Use the following command to specify the standard to be applied. 


CLI (voice-port)> caller-id { none | dtmf | fsk } 


Use the following command to specify the initial ring tone (ms) for caller-id. 
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CLI (voice-port)> initial-ring <10-2000> 


Use the following command to define the ringing voltage, for analog ports only, (default: normal). 


CLI (voice-port)> ring-level { normal | high | max } 


See 4.2.3.6 for more information about the available ring levels. 


7.2.3.4 Parameters for Tones 
Use the following command to specify the tones signal parameters. The frequencies and durations used 
comply with the selected country specifications. 
CLI (voice-port)> tone { France | Germany | USA | Italy | Spain | UK | 
userdefined } 
Use the following command to specify the transmit level for tones (dBm). Default: -10 dBm. 


CLI (voice-port)> tone-level <-40 to 0> 


Use the following commands to define the parameters for each user-defined specific tone. 


CLI (voice-port)> user-tone { dial | network-failure | congestion | busy | 
callback } 


The following command must be entered to use a timing parameter (continuous tone if disabled). 


CLI (voice-port)> timing enable 


Use the following command to cancel the timing parameters (the tone is continuous). 


CLI (voice-port)> timing disable 


Use the following command to define the durations for three successive signals (in millisecond). 








CLI (voice-port)> timing customs <on-1> <off-1> [<on-2> <off-2> [<on-3> 
<off-3>]] 
Use the following command to define the frequency (Hz) for a simple tone. 
CLI (voice-port)> frequency single <300-3400> 


Use the following command to define a dual frequency tone (where signals of different frequencies are 
addeqa). 


CLI (voice-port)> frequency dual <300-3400> <300-3400> 


Use the following command to define a tone where signals of different frequencies are multiplied 
(frequency modulation). 


CLI (voice-port)> frequency modulate <300-3400> <300-3400> 


7.2.3.5 Parameters for Dialing 


Use the following command to define the transmit level for DTMF digits (dBm). Default: -12 dBm. 
CLI (voice-port)> digit-level <-32 to 0 dBm> 


Use the following command to define the transmitted DTMF digit duration. Default: 100ms. 


CLI (voice-port) > digit-duration <50 to 1000 ms> 


Use the following command to define the minimum delay between two DTMF digits (for transmission 
towards the terminal). Default: 100ms. 


CLI (voice-port)> inter-digit <50 to 1000 ms> 
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7.2.4 Internal Local Voice Port (POTS) 


The command for the creation of a local POTS port associated with the 5/0 physical port is: 


CLI (configure)> dial-peer voice pots 1 
CLI (pots)> port 5/<port> 
CLI (pots)> exit 





Each dial-peer voice pots must be identified by an arbitrary index from 0 to N. The physical port numbering 
is defined in the product installation manual. 


7.2.5 MGCP Gateway 


This command defines the global parameters for the H.323 gateway: 


CLI (configure) > mgcp-gateway 
CLI (mgcpgw) > 


7.2.5.1 Parameters 


Use the following command to shutdown the MGCP gateway. Changes on parameters concerning the 
MGCP gateway are effective after a shutdown/no shutdown operation. Default: shutdown. Enter the no 
shutdown command when you have completed the configuration of the MGCP gateway parameters. 


CLI (mgcpgw)> [no] shutdown 
Use the following command to define the IP interface attached to the MGCP gateway (may be Ethernet, 
FastEthernet, ATM, PPP ...) that serves as source IP address of the gateway. The IP address of the 


MGCP gateway is the IP address configured for this interface (or dynamically acquired in case of PPP/IP- 
CP). 


CLI (mgcpgw)> gw-interface <IP interface> 
Use the following command to configure the call agent IP address and UDP port. The UDP port is optional 
(default: 2727). 

CLI (mgcpgw) > call-agent-add <IP-address>[:<port>] 
Use the following command to define the gateway identifier for the call agent (mandatory). identifier is 
a string of 40 characters maxi. 

CLI (mgcpgw) > gw-id <identifier> 
Use the following command to define the UDP port range used for RTP (each 0-65535). Default 16384- 
16482. 

CLI (mgcpgw)> rtp-port-range <0-65535> <0-65535> 
Use the following command to send RSIP packets periodically to keep NAT sessions open on the path to 
the call agent (not active by default). 

CLI (mgcpgw)> [no] keep-alive 
Use the following command to specify the time interval to use for the MGCP keepalive timer if option 
keepalive is set. Default value is 30 sec. 


CLI (mgcpgw)> keep-alive-timer <10..600 seconds> 


Example: 


CLI (configure) > mgcp-gateway 

CLI (mgcpgw) > gw-interface ATM 0.1 

CLI (mgcpgw 
( 
( 


)> call-agent-add 10.2.2.1 
CLI (mgcpgw) > rtp-port-range 32000 36000 
CLI (mgcpgw) > no shutdown 
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7.2.6 VoIP Coder Profiles 


It is possible to define a list of coders for the terminal capabilities. The list contains the preference order, in 
which the codec shall be used when negotiating the codec with the remote VoIP endpoint. 


Commands: 


CLI (configure) > voip-coder-profile 1 
CLI (voip-coder)> codec 1 g711 20 
CLI (voip-coder)> codec 2 g729ab 10 


Parameters: 





CLI (voip-coder) > codec <preference-index> <codec> [<sample-time-length>] 


e preference index: indicate the position in the list of coders (1 to 10). 

e codec: may be g729ab, g711a, g711u. 

e sample-time-length: period of frames transmission (in ms). Allowed values are: 
e = g729ab: 10, 20, 30, 40. Default: 20. 
e g7lla, g711u: 10, 20, 30, 40. Default: 20. 


The selected coder will be the first one in the list matching with the remote capabilities. 
7.2.7 Voice over IP Dial Peer 


The VoIP port is defined as a 'Voice over IP Dial Peer’, that identifies an MGCP endpoint. 
To create a dial-peer VoIP, enter: 


CLI (configure) > dial-peer voice voip <index> 


One can create several VoIP dial peers; therefore, an arbitrary number identifies each dial peer. 
7.2.7.1 Parameters 


Use the following command to define the protocol used for this dial-peer. It must be set to “MGCP” (the 
default value is h323). 


CLI (config-dial-peer)> sig-protocol { h323 | sip | mgcp } 


Use the following command to define the local port bound to this MGCP endpoint (dial-peer port). 

CLI (config-dial-peer) > mgcp-dppots <dial-peer pots identifier> 
Use the following command to define the name of the endpoint. The recommended value is "aaln/x" 
where x is the port number. 

CLI (config-dial-peer) > mgcp-ep <endpoint name> 
Use the following command to define the coder profile to use. Default: 0. If the coder profile is not defined, 
the G.711A/20ms coding mode is used. 

CLI (config-dial-peer) > voip-coder-profile <0-9> 
Use the following command to enable the silence detection and suppression. The value vadcng can be 
used for G711 and G726 to enable the comfort noise generation (this feature is de-facto enabled if vad is 


configured with G729AB and G723.1). Use the no form to disable the voice activity detection. Default: 
disable. 


CLI (config-dial-peer)> silence-detection { vad | vadcng } 
Use the following command to specify the DIMF management mode. If ‘out-of-band’ is selected, DTMF 


are sent using DTIMF MGCP package. If in-band is selected, the DTMF are transmitted in RTP frames (cf. 
RFC 2833). Default: none. 
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CLI (config-dial-peer)> dtmf-relay { none | in-band | out-of-band } 


Use the following command to specify the fax management. Default: none. It specifies the fax 
management. Default: none. passthrough is configured for an automatic codec switching to G.711. The 
method is configured by the command passthrough-mode. 


CLI (config-dial-peer)> fax-relay { none | passthrough | T38 } 


Use the following command to define the number of T.38 frames for redundancy. Default: 2. 
CLI (config-dial-peer) > t38-redundancy <0-4> 
The T.38 fax relay is supported in strict or loose mode. The strict mode requires the remote gateway to 


explicitly indicate T.38 support, so that a T.38 fax relay communication can start. Refer to draft- 
andreasen-mgcp-fax for more information. 


CLI (config-dial-peer) > mgcp-t38-mode { none | loose | strict } 
Use the following command to enable the automatic modem detection. Default: no. The method used for 
up-speed is defined by the command passthrough-mode. 

CLI (config-dial-peer) > modem-passthrough 
Use the following command to define the jitter max value. Default: 100ms. The jitter compensation buffer is 


initialized such that it is half-way filled. When the jitter compensation buffer is filled above this limit, an 
excessive jitter event is raised indicating that the voice flow encounters severe jitter. 


CLI (config-dial-peer)> jitter <20..1000 ms> 
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7.3 CONFIGURATION EXAMPLE 


To use these configuration examples, copy & paste the following command lists in a configuration file or to 
the CLI. 


Configuration environment: 4 FXS ports 


! Physical voice ports declaration 
voice-port 5/0 

exit 
voice-port 5/1 
exit 
voice-port 5/2 
exit 
voice-port 5/3 
exit 





! local voice ports 








dial-peer voice pots 0 
port 5/0 

exit 

dial-peer voice pots 1 
port 5/1 

exit 

dial-peer voice pots 2 
port 5/2 

exit 

dial-peer voice pots 3 
port 5/3 

exit 





! Voice coder list (terminal capabilities) 





voip-coder-profile 1 
codec 1 g729ab 20 
codec 2 g7lla 20 
exit 


! dial-peer voip : remote voip devices 


dial-peer voice voip 0 
sig-protocol mgcp 
mgcp-dppots 0 

mgcp-ep aaln/1 
voip-coder-profile 1 
exit 





dial-peer voice voip 1 
sig-protocol mgcp 
mgcp-dppots 1 

mgcp-ep aaln/2 
voip-coder-profile 1 
exit 





dial-peer voice voip 2 
sig-protocol mgcp 
mgcp-dppots 2 

mgcp-ep aaln/3 
voip-coder-profile 1 
exit 





Page 7.3-152 of 166 


ONEOS V4.2R5 VOICE USER GUIDE (EDITION 5) 


dial-peer voice voip 3 
sig-protocol mgcp 
mgcp-dppots 3 

mgcp-ep aaln/4 
voip-coder-profile 1 
exit 





! MGCP gateway global parameters (gatekeeper) 


mgcp-gateway 

gw-interface fastethernet 0 
call-agent-add 200.15.0.103 
gw-id oneaccess.com 

no shutdown 

exit 
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7.4 STATISTICS DISPLAY 


The Command Line Interface provides access to statistics and configuration status for the voice service. 
The 'show' commands can be used at any level in the CLI tree. 


The syntax is the following: 


CLI> show voice <parameters> <index> 


With: 
parameters: Defines the port or the connection. 


index: Specifies the port or connection number. al1 specifies all ports or connection. 


7.4.1 FXS Voice Port Statistics 


To show statistics on a FXS physical port, enter: 


CLI> show voice voice-port fxs index 0 





voice port 5/2 
current state on hook 
config state up 
attached mgcp dial peer 0 
voice communication no 
Outgoing calls 0 
Outgoing calls failures 0 
Unsufficient pots-group resource 0 
User busy (17) 0 
No answer (18) 0 
Incoming calls 0 
Incoming calls backup invoked 0 
Incoming calls failures 0 
Remote failure 0 
Unknown number 0 
DSP unavailable 0 
No VoIP ressource available 0 
Not specified 0 


Note: 


e Outgoing call statistics are related to the calls towards the FXS device or network (transmitted by the 
OneOS-based voice-capable router on this port). 


e Incoming call statistics are related to the calls coming from the FXS device or network (received by the 
OneOS-based voice-capable router on this port). "Remote failure" indicates that the failure has 
occurred on the outbound port (VoIP or local). 


e Voice communication is indicated as "yes" if a communication is in progress. 


e show voice voice-port fxs all displays statistics on all the voice ports. 


7.4.2 Dial Peer VoIP Statistics 


To show statistics for the dial-peer VoIP <port-—id>, use the following command: 


CLI> show voice dial-—peer voice voip index <port-id> [<type>] [reset] 
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To show statistics for all the dial-peer VoIP, use the following command: 


CLI> show voice dial-peer voice voip all [<type>] 


type may be: 


current: Statistics on current calls. 


outgoing: statistics on outgoing calls only. 


incoming: statistics on incoming calls only. 


user-plan: statistics on voice & fax only. 


all (default): all the statistics are provided. 


CLI> show voice dial-peer voice voip index 0 


Dial Peer 
Current protocol 
Current Calls 


Outgoing Calls 


Outgoing calls failures 

RAS Call Failures 
Admission time-out 
Admission Rejects 

H225/0931 Call failures 


Cause Cl 
Cause Cl 


Cause Cl 
Cause Cl 
Cause Cl 
Cause Cl 
Cause Cl 
Cause Cl 


H245 Call 


h323 
Outgoing Calls 
221 
14 
0 
14 
lass 0 (normal event) 
lass 1 (normal event) 
Normal Cause (16) 
User busy (17) 
No answer (18) 
lass 2 (unavailable ressources) 
lass 3 (unavailable service) 
lass 4 (service not provided) 
lass 5 (invalid message) 
lass 6 (protocol error) 
lass 7 (interworking) 
failures 


Incompatible capabilities 





Protocol 
Internal call failures 


errors 


DSP unavailable 
Max-bandwidth exceeded 





Max-connection 


XC 


ded 


Gateway not registered 
Gateway status down 


Not specified 


Incoming calls 


Incoming Calls 


Incoming calls failures 
RAS Call failures 
Gatekeeper Unavailable 
Admission Rejects 
Local Port Call failures 
H245 Call failures 
Incompatible capabilities 
Protocol errors 


Internal call failures 


DSP unavailable 


Unknown number 


345 
14 


Channel / port unavailable 
Max-bandwidth exceeded 





Max-connection 
Not specified 


Advice-of-charge 


RTP statistics 


Voice & Fax statistics 


XC 


ded 


Number of transmitted packets 


[reset] 


14 


oOo 
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oOo 


een eRe ene) 


ome) 


rFPOOAOCO 


35 
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umber of received packets 40 
umber of transmitted bytes 11620 
umber of received bytes 13280 
umber of excessive jitter events 0 
umber of lost packets 0 
umber of invalid packets 0 
Number of calls with frame error rate 
total <0.01% <0.1% <0.5% <1% <5% >=5% 
565 565 0 0 0 0 0 


Modem passthrough 
Number of switching to modem mode 0 
T38 FAX Calls 
Number of outgoing fax 
Number of incoming fax 
Number of failures 
Request Mode failure 
Pre-message procedure failure 
Page failure 
Number of transmitted packets 
Number of received packets 
Number of transmitted bytes 
Number of received bytes 
Number of lost packets 

















QO 'O'Or'O@: OC: Oro. Oa 


Note: 


e Outgoing call statistics are related to the calls towards the H.323/SIP network (transmitted by the 
OneOS-based voice-capable router to the remote VoIP device. 


e Incoming call statistics are related to the calls coming from the H.323/SIP network (received by the 
OneOS-based voice-capable router from a VoIP device). "Remote failure" indicates that the failure 
has occurred on the outbound port (local). 


7.4.3 MOS Scoring Statistics 


The following command gives statistics about the voice quality: 


CLI> show voice mos 








Call Quality 





Number of Call 20 
Average of MOS : 3.58 
Minimum MOS 24.38 
Maximum MOS > 4.29 
Average of ERL 2 41 
Average of ACOM Oud 
Average of loss-rate : 0 
Average of jitter : 14 
Average of Max delay : 16 








Use the following command to reset and restart the MOS scoring statistics: 


CLI> show voice mos reset 


7.4.4 MGCP Gateway Statistics 


The following command gives statistics about the gatekeeper: 


CLI> show voice mgcp-gateway 


Call Agent IP address 200.105.0.103:2427 
Connection state connected 
Current Calls 0 


Outgoing Calls 
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Outgoing Calls 0 
Outgoing calls path established 0 
Incoming Calls 
Incoming Calls 0 
Incoming calls path established 0 


Note: 


Outgoing call statistics are related to the calls coming from the analog phone 
Incoming call statistics are related to the calls sent to the analog phone 
Voice communication is indicated as "yes" if a path is established 


The connection state is “connected” when the RSIP message is acknowledged 


7.4.5 Events 


FXS port <5/x> event {off-hook | on-hook | ringing on | ringing off}, pots 
= <dp pots>: event on FXS analog port. 


Digit <x> received, pots = <dp pots>: digit reception (dialing). 
MGCP Call Agent connection: connected to the call agent (RSIP acknowledged). 
MGCP Call Agent connection failure: connection error. 


Voice port <5/x> status change: {shutdown | no shutdown}: indicates that the 
interface has been shutdown by the operator. The port cannot be used for calls. 


GCP RTP transmission {started | stopped}, dp-voip = <dp voip>, coder 
<coder>: indicates that the OneOS-based router has started (or stopped) to send RTP packets. 





GCP RTP reception {started | stopped}, dp-voip = <dp voip>, coder <coder>: 
indicates that the OneOS-based router is able (or not able) to receive RTP packets. 


GCP FAX T38 starting, dp-voip = <dp voip>: start of the T38 call. 
GCP FAX T38 end of call, dp-voi p = <dp voip>: end of the T38 call. 


GCP FAX T38 call failure, dp-voip = <dp voip>, cause <T38-cause>: indicates the 
T38 cause. 





GCP FAX T38 Pre-message procedure OK, dp-voip = <dp voip>: indicates that the T38 
call is connected. 


GCP FAX T38 {receiving | transmitting} page <n>, dp-voip=<dp voip>: indicates 
that the page n is being received / transmitted. 





GCP FAX T38 page <n> {OK | KO}, dp-voip = <dp voip>: indicates that the page n has 
been received / transmitted OK or not. 


GCP FAX T38 <n> IFP packets lost, dp-voip = <dp voip>: indicates a T38 
transmission error. 


GCP FAX/Modem start of detection, dp-voip = <dp voip>: indicates that a fax or 
modem call is being detected. 





GCP FAX/Modem end of detection, dp-voip = <dp voip>: indicates that the detection 
phase has ended. 


DSP failure <dsp number> <failure nb>: indicates a DSP internal error (software crash). 








GCP <number> invalid voice packets received, dp-voip <dp voip>: number of 
invalid voice packets received. 


GCP <number> voice packets lost, dp-voip = <dp voip>: number of voice packets 
lost. 











GCP <number> excessive jitter, dp-voip <dp voip>: the jitter is greater than the 
configured threshold value. 
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7.5 TROUBLESHOOTING TOOLS 


Events and statistics described above should be used first for troubleshooting call failure. This section 
describes other useful tools. 


7.5.1 LED 
7.5.1.1 _OneOS-based voice-capable router ONEXX0O 


Led 'Voice': 
e Green: Voice service fully operational. 
e Red: Voice service configured but not fully operational. 


e Off: The voice service is not configured. 


The voice service is fully operational if all these conditions are OK: 
e The IP interface attached to the MGCP gateway is UP. 


e The connection with the Call Agent is established. 


Led 'Com': 
e Green: At least one voice communication (path) is established. 


e Off: No voice communication in progress. 
7.5.1.2 |ONE100/300 


Led 'Voice/Com': 

e Green: Voice service fully operational, no call in progress. 

e —_ Blinking green: Voice service fully operational, call in progress. 
e Red: Voice service configured but not fully operational. 


e Off: The voice service is not configured. 
7.5.2 MGCP protocol capture 


It is possible to display on the console port or on a Telnet client the packets which are exchanged between 
the MGCP gateway and the call agent. 


To display the packets: 
CLI> [no] debug mgcp 


7.5.3 RTP Call Detailed Reports 


The RTP session monitoring feature gives history information about jitter and packet loss. The last 200 
calls and the current calls are monitored. 
To display the statistics: 

CLI> show voice rtpcall { short | full } { any | err } { all | min <vall> 


max <val2> | ind <value> } 


Two modes are available: 
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e short: Statistics summary 
full: all the statistics 


A filter can be applied to get only the calls with errors: any or err 


The calls are numbered as following: the 1st is the most recent one and the last call is the oldest one. The 


first calls can be in progress or not. 

Several options are available to select the calls: 
e all:all the calls from 1 to 100 
e min <valuel> max <value2>: all the calls between value1 and value2 
e ind <value>: the call specified by the value 
Example: 


CLI> show voice rtpcall short any min 1 max 3 



































1 - 01/04/01 O00h47m43s RTP 20.5.3.131:16418 - 200.15.0. 
Play time (voice) O0O0OhO00m47s 
RTP Packets RX / TX 2338 / 2337 
RTP Packet lost&discarded RX / TX (RTCP reported) 
Number of Excessive Jitter events : 1 
ax Interarrival jitter (uplink) Rx / Tx: 9 ms / 1 
2 — 01/04/01 O00h47m24s RTP 20.5.3.131:16416 - 200.15.0. 
Play time (voice) O0OhO0O0Om46s 
RIP Packets RX / TX 2337 / 2338 
RTP Packet lost&discarded RX / TX (RTCP reported) 
Number of Excessive Jitter events : 1 
ax Interarrival jitter (uplink) Rx / Tx: 9 ms / 1 
3 - 01/04/01 O0h47m05s RTP 20.5.3.131:16414 - 200.15.0. 
Play time (voice) O0OhO00m47s 
RTP Packets RX / TX 2332) -f° 2331 
RTP Packet lost&discarded RX / TX (RTCP reported) 
Number of Excessive Jitter events : 1 
ax Interarrival jitter (uplink) Rx / Tx: 9 ms / 1 
In full mode: 
CLI> show voice rtpcall full any ind 2 
2 —- 01/04/01 00h47m24s RTP 20.5.3.131:16416 - 200.15.0. 
Play time (voice) OOhO0O0Om46s 
Tx Coder G729 / 20 ms ; Rx Coder G729 
VAD enabled local / remote no / no 
ERL —-— dB 
ACOM —- dB 
RTP Packets received (DSP / Uplink) 2337 / 2337 
lost 0 
out of sequence 0 
invalid : 0 
RTP Packets transmitted (DSP / Uplink) 2338 / 233 

















lost (RTCP reported) 0 
Jitter parameter 100 ms 
Number of Excessive Jitter events 1 
Excessive Jitter events 
2 | 
dl) - 
o 30" 1' 23 4! 8' 12' >16' 


152:16390 
0 / 0 

ms 
152:16388 
0 / 0 

ms 

152:16476 
0 / 0 

ms 

152:16388 

8 
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Press any key to continue (Q to quit) 


Jitter received (uplink) 
ax delay : 93 ms 


Delays (ms) S50 2100. 3150 
b of occur. 2 0 0 
Interarrival max jitter : 9 ms 


Jitter received (DSP) 
ax delay : 93 ms 








Delays (ms) >50 >100 >150 
b of occur. 2 0 0 
Interarrival max jitter : 9 ms 


Frames with a delay >50 ms 


A: | * * 





0 630" 1. 2° 4' Bt LAN S16" 


Jitter transmitted (uplink) 
Max delay : 6 ms 


Delays (ms) >50 >100 >150 
Nb of occur. 0 0 0 
Interarrival max jitter : 1 ms 

(RTCP reported) : 2 ms 


Notes: 


the 1 





When a value has not been calculated, it is replaced by a 
ERL & ACOM when an echo situation has not been encountered (an echo situation is a high 
transmitted audio signal and low received audio signal), no RTCP packets received. 





>200 


>200 


>200 
0 


>300 


>300 


>300 


ERL is the Echo Return Loss measured before echo cancellation. Acom is the echo return loss 
measured after echo cancellation. 


. Examples: uplink analysis is disabled, 


A graph indicates the time distribution of the errors. The 30 sec column indicates the number of errors 
occurred between 30 sec and 1 min after the beginning of the call. 


For the jitter statistics, “delay” means the time between two packets decreased by the normal time. 
Example: a delay of 80ms for a 20ms coder sample length causes a jitter of 60ms towards expected 


value. 


The inter-arrival jitter is calculated for each packet in conformance with the RFC3550. The indicated 
value is the max jitter observed during the call. 
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8 RTP CLOCK SYNCHRONIZATION 

8.1 OVERVIEW 
The RTP clock synchronization solution is designed to synchronize real-time clocks in the nodes of a 
distributed system communicating over an IP packet network. The clock synchronization mechanism 
overcomes the asynchronous nature of packet switched networks and regenerates a reference clock 
accurately across the IP network. 
Packet arrival at a particular network node is typically characterized by slow and smooth drifting of packet 
arrival rate referred to as wander (mimicking the original transmission clock drift) and fast random jumps 
caused by processing delays (caused by routing and switching nodes, packet bursts, congestion, overload 
or topology changes) that are called jitter. The RTP clock synchronization solution makes it possible to 
recover a reliable clock from a stream affected by jitter. Namely: 
Quickly derive the reference clock from the packet stream, 
Lock onto the reference clock and regenerate a clean clock signal, 
Adapt the system clock to track the reference clock and maintain long-term accuracy. 

8.2 DESCRIPTION 


The OneAccess solution is based on two or more OneOS peers. One peer extracts the reference clock 
from a reference interface (such as PRI connected to the public network) and transmits it over the packet 
switched network. The remote peer(s) regenerate(s) the clock rate distributed by the originating node. The 
synchronization solution is four-fold: 


1. It captures the reference clock rate from which other nodes in the network derive their own clock 
thus establishing a hierarchy of time synchronization. The reference clock is derived from an 
extremely accurate clock on a T2 or TO interface or via the xDSL uplink that usually delivers the 
ATM network physical layer clock reference. 


2. The packet switched data network does not inherently deliver any clocking information to network 
nodes therefore the OneAccess solution uses out of band packets to transfer the clock information 
to other network nodes. It transmits the original clock via RTP packets sent at a specific stream 
rate. 


3. The distribution of the reference clock information over the packet switched network exploits the 
routing capabilities of IP networks and offers two options: 


° Point-to-point clock distribution to synchronize a reference clock with one or several pre- 
configured remote peers: 
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Public ISDN 
Network 
Reference 
Clock 
Typical point to point clock synchronization application 
° Point-to-multipoint clock distribution by means of multicast routing protocols: 
Regenerated iza a A PRI Public ISDN 
Clock tae ‘ = Network 
Reference 
Clock 
Regenerated _ de kedededededededed, 
Clock 
IGMP Multicast routing domain 
PIM-SM 
Typical point to multi-point clock synchronization application 
4. The receiving node processes the synchronization packets with a kind of averaging process that 


annihilates the effect of jitter and captures the reference clock rate. It then regenerates a clean 
clock signal derived from the reference clock. The algorithm also detects changes happening in the 
network and adapt to these variations in order to track specifically the reference clock. 





8.3 ALGORITHM 


The regeneration of the reference clock is based on a jitter buffer that absorbs the network delay 
fluctuations and clocks out the incoming data at a precise rate locked on the reference clock. 
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Jitter Buffer 


Random Accurate 
arrival rate 
Jitter Buffer Pr inciple 


The device internal oscillator is driven by the clock synchronization algorithm such that buffered data are 
read out at a constant rate matching the reference clock rate. The continuous adjustment of the buffer 
output rate to the reference clock is called adaptive clocking. 


The RTP stream is dedicated to adaptive clock recovery. It is combined with advanced algorithms allowing 
OneOS to filter out the network transmission delay and calculate over time the variation of the network 
jitter together with the difference in packet time transmission introduced by the clock drift between the 
reference clock and the device internal clock as pictured below. 





Clock drift 


Packet Network Jitter + 
Clock drift 


Network Jitter and clock drift measurement 


These calculations are used to determine the clocking difference between the device’s clock and the 
reference clock represented by the slope of the linear interpolation of the jitter + clock drift curve. The 
correction factor value to be applied to the device oscillator directly flows from this slope and allows 
OneOS to synchronize the buffer clock rate to the reference clock rate. The slope represents the direction 
and magnitude of the clock difference between the two ends of the network. 


The OneOS clock synchronization algorithm is designed to ensure: 
e Fast convergence of the devices’ clock toward the reference clock. 
e Complete filtering of the network jitter and packet delay variation to recover the exact reference clock. 


e Track short-term deviations of the reference clock to guarantee data integrity for upper layer 
applications. 


These seemingly contradictory goals are achieved with a multistage algorithm as illustrated below. 


In a first phase called Fast Convergence (phase #1) the algorithm makes coarse adjustments of the clock 
rate to rapidly converge toward a good approximation of the reference clock. Clock adjustments conclude 
observation periods during which OneOS monitors the jitter and clock drift variations. A slight or null slope 
indicates that the clock difference between the two ends of the network is almost zero. 
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Packet Network Jitter + 
Clock drift 


Observing the difference between the device’s clock and the reference clock for some time can be seen as 
a kind of averaging process that filters the effects of the random network variations to capture the original 
clock rate. 


At the end of the Fast Convergence phase OneOS already has synchronized the clock to a decent 
estimate of the reference clock and enters into the Fine Convergence (phase #2) mode. The fine 
convergence mode defines longer monitoring periods allowing OneOS to filter out the random delay 
variations introduced by the network. Fine clock rate adjustments are driven by slope calculations during 
these periods. Any frequency discrepancy between the reference and device’s clocks is eventually 
compensated, and the OneOS precisely aligns the two clock frequencies. 


Finally, when the clock difference has gotten small enough, OneOS enters in the Tracking Mode (phase 
#3) which is designed to optimize clock adjustments so that the regenerated clock follows oscillations of 
the reference clock. In this phase OneOS uses much smaller clock adjustments but the frequency of the 
adjustments is increased to better track the reference clock variations and avoid late corrections of the 
clock rate. 


The algorithm includes defense mechanisms that allow OneOS to downgrade the synchronization process 
from one mode to another in order to ensure fast clocking convergence even in adverse network 
conditions (network outages, packet loss, congestion...). 


Clock adaptation & 


Jitter Clock drift 





I I I time 


Fast Convergence Fine Convergence Tracking mode 


Clock Synchronization process 


The process used by OneOS to mimic the reference clock rate is actually more sophisticated than that 
described above. Complex digital signal processing techniques are applied to determine the best clock 
correction values and the optimum threshold values allowing moving from one stage to another. 
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8.4 CONFIGURATION 


8.4.1 Voice ports 


To enable the RTP clock synchronization, the following command must be entered in the voice-port 
parameter group: 


CLI (configure) > voice-port 5/0 
CLI (voice-port) > clock-source rtp 
CLI (voice-port)> exit 


8.4.2 Peer-to-Peer Mode 


This mode is configured on the client device only: the internal call generator is used to call a remote device 
which is synchronized on the reference clock. The remote device may be an OneAccess gateway with the 
automatic internal responder. 


To enable the RTP synchronization, the internal call generator must use a dial-peer pots with a specific 
service enabled: 


CLI (configure) > dial-peer voice pots <n> 
CLI (pots)> service clock-recovery 
CLI (pots)> exit 





Note: the “start auto” command must be entered in the VoIP call generator, to have the clock 
synchronization achieved after a power on. 


8.4.3 Multicast mode 


For this mode, a specific parameter group is defined: 


CLI (configure) > voice-global 
CLI (voice-global)> rtp-multicast 
CLI (rtp-clock)> 





Use the following command to define the RTP mode: 
CLI (rtp-clock)> mode {receiver | transmitter} 
The “transmitter" mode is used on the server side: the device generating the RTP flow synchronized on the 


reference clock source. The “receiver” mode is used on the client side: the device which get the 
synchronization from the RTP flow. Default: receiver. 


Use the following command to define the IP address of the multicast group. 


CLI (rtp-clock)> group-address <IP address or hostname> 


Use the following command to define the IP source address of the RTP flow (used on the transmitter and 
checked on the receiver side). Default value: empty (no check). 


CLI (rtp-clock)> source-address <IP address or hostname> 


Use the following command to define the UDP port to be used. It must be configured to enable the service 
(no default value). 


CLI (rtp-clock)> udp-port <port 1-65535> 
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Use the following command to define the payload type to be used in the RTP header. Default: G711. 
CLI (rtp-clock)> payload-type <number 0-127> 


Use the following command to define the time (ms) between two successive RTP packets. Default: 20ms. 


CLI (rtp-clock)> timestamp <10-20-40> 


Use the following command to define the time to live (set on the transmitter side). Default: 255. 


CLI (rtp-clock)> ttl <1-255> 


Use the following command, only on the transmitter side, to define the IP interface to disable in case of 
loss of reference clock. It is useful for a backup purpose, with several multicast server devices. Default: 


disable. 


CLI (rtp-clock)> [no] sync-interface <ip interface name> 


Use the following command to disable or enable the service. The service must be disabled by this 
command before any parameter value change. 


CLI (rtp-clock)> [no] shutdown 





8.5 STATISTICS 


The following command gives some statistics: 


CLI> show voice clocking 


Server side 





RTP clock sender is up and running 
Clock frequency 20 ms 
IP destination address 224.1.1.1:7878, ttl 15 
Source address 192.168.230.2:7878 
Packets sent 5614765, dropped 0 
rate 50 pps (last 4 sec), 50 pps (last min), 50 pps (life avg) 


Client side 


RTP clock receiver is up and running 
IP destination address 224.1.1.1:7878 
Source control disabled 
Source 192.168.230.2 since FEB 01 00:04 2000 (l1d6h1m) 
packets received 5399711 
rate 50 pps (last 4 sec), 50 pps (last min), 49 pps (life avg) 





Events are also defined in “event filter add vox voip userplan gen” event group to follow any 
phase change. 
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